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MTOBS COMMENT 



Most of you will by now have discovered (he new price them on io othi 
for CDU. We are very sorry that we have had to make (his For people who 
the cost of your favourite C64 magazine. Like provided a very 
" -imply ' 



ant fy at the mercy of ihe 
e of the country. However, we 
do feel that even at the new prfee of £3.25, CDU still 
Hives uuu.mding value lor m«ne\ and «■■(.> will entleuvoui- 
to continue to keep up the standards. 

I hope you like the new style disk sleeve and disk logo. 
Many of you have staled your preference to having Ihe 
VOLUME and DISK number on the disk, instead of on the 
sleeve as in the past I must say thai I agree. 

This months issue is full of interesting features which I 
trust you will find will be of some benefit to you. One of 
Ihe programs on ihe disk., namely " lurbo Loader" does not 
have any text associated with it. This is due to the fad 
that we received it too late for printing. However, the 
program is self explanatory so it should not present you 
with any problems. Please enjoy this issue. 



DISK INSTRUCTIONS 

Although we do everything possible to ensure that CDU 
is compatible with all C64 and CI 28 computers, one 
point we must make clear is this. The use of 'Fast 
Loaders', 'Cartridges' or alternative operating syslems 

■■II' ■■ ■!■■ I I"!.'' ': : ii i'i 1-1 r -... '.;;!,. I, .ll|,.>- lll.il Vol.11 .|i-l, 

will function properly. If you experience problems and 
you have one of the above, then we suggest you disable 
Ihem and use the computer under normal, standard 
conditions. Getting tin- programs up ,intl running should 
not present you with any difficulties, simply pul your disk 
in the drive and enter ihe command. 

LOAD"MENU",8,1 

Once the disk menu has loaded you will be able to start 
any of [he progiams simply be selccling Ihe desired one 
from the list. It is possible lor some programs lo alter the 
computers memory so lhat you will not he able to LOAD 
programs from the menu correctly until you reset the 
machine. We therefore suggest that you turn vour 
computer off and then on again, before loai 



in, ike le'.iiiir.iie copies, we 
machine code file copier. T 
!tn FILE COPIER from the 
Instructions are presented on screen. 

DISK FAILURE 



If for any reason ihe disk with your copy of CDU will not 
work on your system fhen please carefully re-read the 
operating instructions in Ihe magazine. If you still 
experience problems I hen: 







progr.i 



HOW TO COPY CDU FILES 



After eight week', a replacement disk can be supplied 
from STANLEY PRECISION DATA SYSTEMS LTD for a 
service charge of £1 .00. Relurn the faulty disk with a 
■ hriiue or poslal order made out to MAN 1 n PRECISION 
DATA SYSTEMS LTD and clearly slate the issue of CDU 
that you require. No documentation will be supplied. 

Please use appropriate packaging, cardboard stiffener at 
least, when returning disk. Do not send hack your 
magazine, only the disk please. 

NOTE: Do not send your disks bark to the above address 
if iis a progmm thai does not appear to work. Only if the 
DISK is faulty. Program faults should be sent to: BUG 
FINDERS, CDU.. Alphavite Publications Ltd, Unit 20, 
Potters Lane, Kiln Farm, Milton Keynes, MK11 3HF. 
Thank you. 



-ON THE DISK 




triple utility to aid Disk Drive users brought to you by FERGAL MOANE 




program (o try and prevent 
some of these mishaps which 
can be potentially very cosily. 
DISK DOCTOR is essentially a 



UNSCRATCH FILE 

When you delete a file using the DOS SCRATCH 

command, il is luckily no! erased from (he disk. The 
entry in the directory track corresponding to thai file is 
simply marked as deleted ,md as such il is ignored liy tin. 1 
DOS. Using this option allows you to recover a deleted 
file, provided you give the correct name. Unscratch lilt: 
in mosl efteclive when used immediately after the delete 
commacul has been issued This is because [lie undeleted 
file mighl he overwritten by other material, saved in the 
space occupied by the old tile. 



CLOSE FILE 

If you use your C64 lor wordprueessing, you will no 
doubt have experienced the loss of a file, usually that 
huge 10,000 word m.islerpiei e! Perhaps a disk error or 
power cut happened when you were saving the file, and 
only part of the file was saved. When you Irv lo load the 
parliallv complete file you get error 60: WRITE FILE 
OPEN. This option jllows ihe file lo be closed properly 
and lo be loaded back into the word pi oi essor. It should 
work with all file types, but il is most effective with 
SEQUENTIAL FILES. 



STORE/RESTORE DIRECTORY 

You will probably be aware of the quick format 
command available on Commodore drives. It lakes the 
form OPEN15,a,tVNEW:disknami'". Nole how the ID 
is lett out. Its function is to clear out the directory of an 
already formatted disk and is far faster lhan relormatlmi.; 
' Ihe entire disk. But what if you have cleared a disk with 



efieciively blank. These two options 
provide a limited but useful archival 
for your disks. Store Directory 
id the directory track of a disk 






v you to ;;ive it 



efor 



storage on anolher disk. When you 
accidentally blank a disk, it is a 
simple mailer of using RESTORE 
DIRECTORY to put Ihe correct 
directory track back on the blank 
disk. Your files are resurrected! My 
advice is to use one clink for storage 01 all ihe directory 
tracks of your mosl important disks. Then when an 
accidental lormal occurs, you can refer to the archive 
disk ini their directory trai ks. Remember 10 nole the 
names lhat you s>ive Ihe files for each disk, this method 
will also recover from corruptions of Ihe directory track 
(error ?1:Directory error!. Restoring an incorrect 
direr lory uould deslri:>\ the i on tents of the disk. Please 
note however lhat this option will NOT recover from a 
full format (including ID). With the long formal 
command, the disk is actually erased and cannot be 
recovered. 



DISKETTE CHECKER 

Tins option allows vou so examine ihe performance of 
the drive, ihe condition oi a whole disk or (rack or a disk. 
DISK DOCTOR will check the disk and report back the 
number of any error lhat Occurs. The main use of this 
01.1t ion is to check to see if disk- are a> iii.dh corrupt and 
lo find the location of ihe error. DISK DOCTOR will try 
and allocate any bail blocks, makin.n sure lh.il valuable 
dala is not pul inlo these dorli;y sectors. Nole lhat in a 
periorriiaisce tcsl the disk will tie destroyed, so please be 



ID CHECKER 

When a disk is ID formatted, the ID number lhat you 
eive in ihe formal command is written on every seclor of 
the disk. If I his (nick ID number is differenl from the disk 
ID, untold prohlems can occur. This is usually caused by 
swapping disk- between ,1 wrile lo the disk and without 
.'iiiiiali-ini; the new rli-k. This command will show up 
any incorrect IDs. Skilled people could use a DISK 



OIM THE DISK 



change Ihe track ID. 



ALIGNMENT ADJUSTER 



This is potentially the most useful command th.it DISK 
DOCTOR provides. Il m.ike? adjustments to how the disk 
drivy li.iiidli-. 'i\iil ciri'H. 1: ivill ■■■■■I. u-, iv- -„j.i" ii ;■: -.■-. m> 
if the disk is nut of alignment with the disk head, chances 
of finding the correct track are immediately doubled. You 
may also specify the number of rimes that the disk drive 
will try and read a particular tr.ick. Again, the more 
attempts ihe drive makes, tin: heller ihe chances are of 
reading the disk correctly. This option will also remove 
the irritating ■WOODPECKER' noise when the drive head 
hits the stop after a read error. Choosing this option will 
reset the 64, allowing you 10 aitempt to load your 
program. I have had considerable success in loading 
misaligned or amuplcil disks hut this is not a miracle 
cure for clinically dead disks! 



DOS COMMANDS 

Finally, this was simply included In allow you to examine 
the directory, issue DOS commands and to check the 
error channel of the drive. The KE5TORE key will return 
you lt> the main menu of DISK DOCTOR at any lime. 

Good luck in doling with li.irl disk blues! 



TIMEWORKS SOFTWARE SALE 



VALUETIME PRODUCTS 



E3 



COMPUTERS 
Amiga 1500 comprising : 
B2000+1 0B4S Monitor+Twin Floppiest 
The Works!* Deluxe Paint 3+3 Games 
Amiga 500 SCREEN GEMS PACK 
comprising ; TV Modulator, 4 Games & 
Deluxe Paint 2 

Amiga S00 Basic Pack comprising : 
TV Modulator, Mouse, Workbench 1 .3, 

■ -,K. Tutorial, Manuals 
Commodore 64C NIGHT MOVES Pack 
comprising ; Cassette Recorder, 8 Games 
fi 2 Joysticks 
Commodore PC Starter Packs! AS SEEN QN TV ] 



Okimate 20 Print heads/Ribbons/Paper 

MONITORS 

Commodore 1084S Stereo Colour Mon 
Philips 8833-II Stereo Colour Monitor 
Philips 7502 Green Screen Monitor 
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PRINTERS 

:en 1 20D+Parallei or Commodore 
LC-10 Parallel 
LC-200 Colour Parallel 
LC 24-10 24 pin Multi-fontl 70/57cps 



Amiga512KRAM/ClockE>:piorA5uD.FreepSp. E 39.00 
Commodore 1541-11 Disk Drive £129.00 

Commodore C2N Data Recorder, p&p. £2 £ 29.95 

External 3.5= Disk Drive for Amiga pSp. £2 £ 59.95 

Power Supply for C64 p&p. £1 £ 26.95 

Supsr-G Parallaf IrterfaCB for C64/12B. p&p. £1 E 34.95 
(Allows use of standard parallel printers on C 64/128 ) 

User Port Parallel Printer Cable p&p, £1 £ 15.99 

SOFTWARE 

Superbase 64 or 128 Free p&p. £ 39.95 

Superscript 64 or 128 Free p&p. E 39.95 

Tasword 64 iOISQ Col WP-Tape or Disk.Free pSp. E 24.95 

Mini Office II for64-Disk Free p&p. £ 19.95 

TAT 17. 5% CARRIAGE £5 (EXPRESS £10) 



T>dt* Pi Softevwie Atct 



8 Ruswarp Lane, WHITBY, N. Yorks Y021 1 ND 
TEL/FAX: 0947 600065 (9am - 7pm| 
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ON THE DISK 




Every serious (..omiTiodnrc Disk User has some slink. 
Even the others have some experience of the stock 
market if they have played "THE FIRST MILLION", 
featured on the February 1 990 disk of CDU. If you own 
more than one slock in your portfolio, il becomes soon 
impossible to really keep track of what is happening to 
your stocks. 

This program, SOLSTOCK.128 was developed for 






like you. Suffer 

To Load, switch on the 
key in the down positk 
and press RETURN. Whi 
in any format which sui 
inform Jlion on the print 



n (SOL: Stocks is j ()r the 



mputer with the 40/B0 display 
Type RUN"SOL5TOCK.12a" 
prompted for the date, type it 
you, since it is only for your 
Jl. After hilling 'RETURN' the 
computer then lo.nl, "SOI S fOCKS.1 2.MC", the m.ic hine 
code for the pull-down menus. I used MENU MAKER 
128 by NICK GREGORY, published in a previous issue of 
CDU. Now that the system is booted, it is time to set up 

TUTORIAL 

Use the cursor keys to move to NEW INFO. Press the 

down arrow or RETURN to select il. Press RETURN again 
to select NEW STOCK DATA. For our example, let's use 
ihe following data. 



II ENTERPRISES INC 
ABC INSURANCE 
COMMODORE INC 
CDU 

Type XXX to end Ihe input. 



300 Stocks 
1 0DD Slocks 
750 Stocks 

1501) Slocks 



Select first the CHANGE menu, then NEW PRICES. You 
will have to retype Ihe date because, after the first time 
you don't have to retype all Ihe stock info, lust reload the 
last stock data, and change the prices. (By loading the 
data, you also load the old date). Type the following 
prices; 



DISK - Lets you Save, Load or Replace your stock, 

OUTPUT - This is used to view the portfolio. 

CHANGE - This is used to type in new prices, to change 
a price (to correct a typing mistake lor instance without 
retyping all the priu's.i. to change the number of stocks, 
to change a stock name, to change the date, to add 
another stock name and to delete a stock name, 

NEW INFO ■ This is used to compile a new stock 
portfolio. 

REORDER - This is used to order the stock names in 
,iipii,iiv;i( ;il order. 

Hfl I' ■ Gives a short help on all of the menu options, 

EXIT - This is used to leave the program. WARNING: if 
you have not saved you sun k data, it will be lost. 



ADVANCED TUTORIAL 

Continue from the tutorial with the same data. If you 
have erased it, enter il again as described m TUTORIAL. 

First of all, you have bought stock in a new company, 
ROBOTICS ALL. Select CHANGE, and then ADD 
STOCK, Enter the name, and the number of stock you 
have decided to buy (250 in this example). 

Next, you have sold all slock of ABC INSURANCE. 
Select CHANGE, and then DELETE STOCK. When ABC 
INSURANCE is displayed, type 'D' to delete it. You have 
also bought an additional 500 stocks of CDU. 5elect 
CHANGE, and then CHANGE NUMBER. When CDU 
appears, type 2000, otherwise just type RETURN. 

At this moment, ROBOTICS ALL's price is still since 
you have not vet typed in anvlhing else. To repair this, 
select CHANGE, followed by CHANGE PRICE. Type 
RETURN until you get to ROBOTICS ALL. Enter the price 



|j ENTERPRISES INC 


7.50 


ABC INSURANCE 


0.75 


COMMODORE INC 


25.78 


CDU 


57.98 



To see what the slocks are worth in tola 
OUTPUT and then SCREEN to see it on the screen, or 
PRINTER to have a hardcopy, (Your printer must be 
device number 4. I have tested it on the CBM801,B01 
and the Seikosha SP-1 B0VO. Now for the oilier options. 



Now select REORDER, and then ALPHABETICAL 
ORDER to order your stock alphahetically. Select 
OUTPUT, followed by SCREEN. 

Now select DISK, and then SAVE DATA to save the 
configuration. Reload it using the LOAD DATA on the 
same menu. Select CHANGE, followed by NEW PRICES, 
Type the following prices; 

ABC INSURANCE 0.5 

CDU 63.03 

COMMODORE INC 27.33 

ROBOTICS ALL 12.B1 
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A disk sleeve utility for those of us wilh NORMAL printers by STEVEN BURGESS 

II your disk-boxes are as disorganised as mine are then, data. This is so that it will fit into the sleeve design 

like me, every lime you want to find a program you without over- or under flowing. You are then relumed to 

probably have to wade tluouL;h rivry one of your disks the menu, 

and directory each one until you find your program Selecting the option PRINT OUT SLEEVE will cause 

which, almost invariably, is on the very last disk you the sleeve to printout straight away so he sure to have 

come to. Enter the answer. the printer set up and some paper in it. The design uses 

This program will let you make a brand spanking new one full piece of printer paper. 

ALONG THE DOTTED LINE 

Once the sir™? kin been printed and you have removed 
I he paper Horn the printer and marvelled sufficiently ,.il 
the sheer brilliance of this program, it is lime to cut it 
oul. Vou cut along the uuin edge m' the design. And then 
you fold along the re 




II llv! If 



irdisk and then st 



s for you to glut 






STRATEGY 
ADVENTURE 

C64 disks only 



your disks. So, when you want lo find ihe disk with your 
Litest blockbusting computer program on it you simply 
llk-k through your box and, iu:y presto, you have your 
disk. The advert over, lei's get down to business. 

THE PROGRAM 

When the program has loaded, and it is nol terribly long 
so it should only lake about half a minute, you are 
presented with a menu. 

The only option you can select al this moment is the 
option ENTER PROGRAM NAMES. Before selecting it, 
however, you must make sure lhat you have the disk, 
which you wish to create a sleeve for, in the drive. Once 
done and drive switched on select the option. 

The screen will clear and then the name of the disk- 
will appear on Ihe screen. Then, one by one. the names 
of all the files will be printed and you will be asked 
which ones you wish to be printed on the sleeve. Be 
careful with which ones you chose, though, because 
r\v I If ih.ii -,■■■. i: bin] lii.M.'i.', I ■,-. ill .ii)|ilmi. 

Once the enlire disk directory has been on the screen 
and you have selected which tiles will be on the sleeve 
you are asked lo wail while the computer formats the 
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The ASTRODUS AFFAIR gets another airing by JASON FINCH 



So the merry month of May is upon us and I will 
be giving nothing away if I tell you that by the end 
of this article you will be on the very edge of 
being able to complete the excellent adventure 
published by CDU last year, THE ASTRODUS 
AFFAIR. Last month I finished by explaining how 
to repair the hole that was causing a few problems 
and this month I shall explain where you go from 
there, including the problem of the stabaTizatJon 
chamber and how to get from the top level to the 
bottom. I shall leave telling you how to replace 
the fuses in the crafts drive so that you can fulfil 
all of the conditions fhat allow you to finish the 
h. Those being having 



th 



-ed/repla 



the fu< 



e corridor repaired, the 
button pressed for navigation and finally the 
correct use of the code 'XX2V. The formal is the 

outline of the method for obtaining the solution to 
a certain problem, followed by a section detailing 
the systematic way about things. Also in lune I 
shall provide you with a full map of the Astrodus - 
Editor permitting, that is! So, let the Astrodus slide 
once again under the microscope... 



THE WALL OF OXYGEN 

>n chamber Is blocked 
>aking from a ruptured 
fjipe. ui course you won i have discovered the 
chamber yet if you haven't solved this problem, so 
it is probably wise to cover this first. Once you 
have repaired the hole, though, you need to set up 
some situations ready for later on, First you must 
drop the globe again and go and switch the power 
off. This will enable ynu to return and move the 
globe to the location immediately east of where it 
was. Then go and put the power back on. The 
globe will be free to move around so long as you 
keep out of locations 12 and 15. If you don't then 
not only will the globe be immobilised, so will 
your attempts at finishing the adventurel You need 
to then go to cross-section B and collect the infra- 
red grenade. It is not intended for consumption by 
you or drygars so don't try feeding it to one of 
them! It will only result in you being covered by 
"steaming drygar meat" with the rest of the bunch 
soon making short work of you. The grenade is 



BREAKING THE BARRIER 

Once the hole is repaired, DROP the GLOBE and 

go WEST and then SOUTH. Turn the power off by 
PRESSing A51X, Return NORTH and then EAST. 
GET the GLOBE and go EAST again. Now DROP 
the GLOBE and go WEST, WEST and SOUTH. 
PRESS A5IX a final lime to switch the power back 
on and go NORTH, EAST and EAST again. The 
globe is nee to miivr elsewhere. Now go SOUTH 
and DOWN the staircase. GET the GRENADE and 
be carefull Go UP, NORTH, EAST, UP another 
(light of stairs and then SOUTH, and SOUTH 
again to location 4. THROW the GRENADE and 
the oiygen will be ignited. Vou are then free to go 
east to the stabalization chamber. However, before 
you do that, return to the globe by moving, 
NORTH, NORTH, DOWN and WEST. 



THE CHAMBER PROBLEM 

I bet you haven't got the rope, have you? Well firsl 
things first - you must get the rope which is 
probably still in the supplies room, return to the 
globe, take it and then tie the rope to it. You can 
then go the stabalization chamber. The globe will 
be attracted to a point above the silver disc at the 
base of the chamber. Because the rope is tied to it, 
and the rope dangles against the side of the 
platform on which you are standing, you can 
simply climb down it to the bottom. That way you 
avoid such pleasant messages as "the floor ... 
races cheerfully towards you with a squelchy 
thud"! To find out exactly what to do, read on; 
otherwise skip to the section labelled CONSOLE 
QUERIES. 



GETTING TO THE BOTTOM 

you don't have the rope, go to the supplies 
om by moving SOUTH, DOWN and WEST. GET 
e ROPE and go back EAST, UP and NORTH. 
jw GET the GLOBE and TIE the ROPE TO the 



** nUEMTIIRIlUR 


GLOBE. Now make your way EAST, UP the 


closes and if you were In location 24 you would 


staircase and then SOUTH and SOUTH again. 


be told that the chamber was 'active'. One more 




piece of the puzzle falls inlo place. Ignore the 


just thai - GO EAST. The globe should be 


next section if you don't want to spoil the fun! 


attracted over the disc and you will be told that 




rather than dangle precariously from the roof of 


P-U-L-L-M 


the chamber, you drop off onto the platform. The 




observant will notice thai "the rope dangles 


EXAMINE Ihe small black CONSOLE and then 


down..., swinging idly against the platform". If 


PULL its EDGES. When it has dropped into your 


that isn't a cue to enter DOWN, then 1 don't 


hand, go UP and then WEST. Now PRESS the 


know whal Ik! 


BUTTON. That was a bit simple wasn't it. 


CONSOLE QUERIES 


THE END ALREADY 


Once at the bottom you should be informed that 


No, noi the end of the adventure - the end of 


there is a black console set into the wall. Upon 


this month's offering of help. Vou have learned a 


examination you should be told that all four 


number of things hopefully and nest month we 


sides are raised away from the wall. The 


will look at the final problems. Incidentally, 


perfectly natural thing to do (?)■ would be to pull 


don'l enter location 23 unless you have the 


the edges and wait for it to plop inlo your hand. 

So do it! But the writer of the adventure has 


laser! More about that in June. All we now have 


lo do is open the safe, retrieve the fuses and put 


pUyecl on vou r curiosity here because everyone 


them in the engine room. Then it's hey presto 


will want to know what the little red button 




does. If you press it then you will find out just 


quest to provide help. Which would you prefer - 


why being pressed against a wall with the floor 


Runaway or the Cranmote Diamond Caper? Do 


rising towards the ceiling isn't really a lot of fun. 


please lei me know! Have fun trying to solve this 


Make sure that you are out of the chamber and 


month's adventures and until thirty odd days 


back in location 4 before you press the button. 


have elapsed, see yer! 



IAMS OF urn 



?ries of Basic lutorinls designed to make the beginner .in expert 
JOHN SIMPSON 



IMPORTANT ANNOUNCEMENT - Due to unforeseen 
luchnical problems, and the fact the your illustrious 
Editor is a bit of a wally, we inadvertently missed out 
the start of section two of this series in the MARCH 
issue of the magazine. Therefore, before this months 
offering gets underway, we present the missing piece for 
viiur enjoyment. 



COMMENCEMENT OF PART TWO 

Let us begin this session by first writing a small program 
which will allow us id gel the cumputei to request some 
input of numbers which we can then manipulate and 
finally display a result. 

Remember to press the return key <CR> after you have 
typed in each line. 



10 INPUT'TIRST NUMBtK";FIRST<CR> 
20 INPUT"SECOND NUMBER";SEC <CR> 
JO LET SUM = FIRST + SEC <:CR> 
40 PRINT"THE RESULT IS"SUM <CR> 
50 END 

Once you have typed in the program, let's refresh our 

memory oi clearing the screen and listing a program 
from the last session (part 1 ), 



-PROGRAMMING 



FIRST NUMBER? (and a flashing cursor) 

You are being prompted lo type in a number. Should you 
type in a letter, or a serifs of letters, or even numhers and 
letters, then the i umputer will respond with: 

(REDO FROM THE START 

This shows you that it is able lo distinguish between a 
number and something else (we'll discus? this more 
closely in a short while). 

Should you perform a <CR> without typing a number ihe 
computer will fill the variable, FIRST, with the default 
value of zero, and then continue lo the next line of Ihe 
program, the screen will now display: 

SECOND NUMBER? [Cursor] 



We have just deleted a piece of program code, namely 
the semicolon, but we can jusl as easily insert code by 
holding down (Ik- SHII- r Key arid tapping ihe INST/DEL 
key which will shift the code to the right opening up a 
space for you to enter new code. Move back to the F in 
FIRST and try this, then type the semicolon back in and 

II you run through the deletion of the semicolon once 
more, then RUN the program (first ensuring that you 
move the cursor back down the screen to a clear line). 
The computer will respond by displaying a syntax error 
message, however, unlike the message which was printed 
in part one, where we used ,i DIRECT COMMAND, this 
error will actually print the line number in which the 
error occurs. In our case (he message will read: 



You < 



e the 



o edit 



THE RESULT IS [first + sec] 

READY 

Let us examine moiv < losi-ly what lias taken place. In 
line 10 we used Ihe Keyword INPUT. This is a command 
to tell the computer to expect the user lo enter sumefhing 
from the keyboard, and lo store it in Ihe van'.ib.e . "■ \< <\ 
FIRST. 

You will have noticed that the keyword INPUT can also 

be used to print information lo the screen. The 
information, like the PRINT command's output, being 
enclosed within quotes "...". Make note of the semicolon 
(;) following Ihe final quote, and before the label, FIRST. 
This is important. Without it Ihe computer will display a 



— ..e. add code, and delete code. If you find the 
need lo delete a whole line, all that is required is lo type 
Ihe line number, on a new line, followed by <CR>. Let's 
try this by deleting line SO in our program: 

SO <CR> 

Now LIST the program and hey presto! line 50 has gone. 
If you decide that you want lo get rid of the entire 
program, this can be done by typing a Direct Command 
(i.e. no line number), namely: 



Try this. Now we have jusl deleted our program. This is 
a useful command, hut one Iraught with danger for when 
you do NEW a program, it has gone foi good! Try LIST 
and you will just receive: READY. The program has 



THE SCREEN EDITOR 

The cursor can lie directed around ihe screen by using a 
combination of the SHIFT key and the cursor keys. The 
cursor keys are Ihe iwo keys next lo ihe right SHIFT key 
and marked CKSR with up/down lerl/righl arrows. To 
move the cursor down the screen use the cursor 
'up/down' key, and to move up the screen hold down a 
SHIFT key together with the same key. To move the 
cursor right use the cursor 'left/right' key, and to move 
left hold down a SHIFT key together with the same key. 

To edit a part of the program move the cursor up to line 
10. and along the line lo the F in FIRST. Now tap Ihe 



You have just used the screen editor. Whenever ■ 
use this editor lo make changes to a line, a 
remember lo press relurn to enter the changes ir 
program. 



gone - with no way to retrii 

STRING INPUT 

We have just seen that we can easily force the user to 
input numbers, albeit only two at a time in the foregoing 
program, although if you wanted lo place more INPUT 
commands plus variable labels you can do so. 

We louched briefly on the term strings, earlier in Part 1, 
but now we shall look inlo them in more detail, A string 
is a group of alphanumeric characters contained within a 
pair of quotes: 

"THIS IS A STRING" 

"AND SO TO IS THIS ABCD1234" 
"1 234567890" is also a string 

How long can a string be? Well CBM basic does allow 
for up to 256 characters, but their is a limitation on a 
basic line length of 80 characters, and this will include 
the line number and statements, so for the time being we 
will restrict ourselves to 40 characters. Later we will 
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p ■ iiv.n 



To distinguish between a numerical input, as used 
and a siring input the dollar sign ( 5 ) is utilised. I 
numerical input we simply type in a label, such as we 
did earlier with FIRST, SEC, and SUM. Simply by haviny. 
no 'prefix', the computer understands that it is dealing 
with numben,. The string input, however, in prerived with 
a dollar ( I ) sign. Right, let's write a small program 
which will demonstrate this by imputing string 
information: 

10 1NPUT"YOUR NAME PLEASE"; NS 

20 LNPUT"YOUR ADDRESS PLEASE";AS 

30 INPUT"YOUR TELEPHONE NUMBER PIEASE";TS 

40 PRINT CHR$(147) 

50 PRINT N$ 

60 PRINT A$ 

70 PRINT T$ 

80 END 



When you RUN this program you will be asked to type 
in your name, spare- an-' allowed, and an before when 
you have typed in your input this is entered by pressing 
<CR>. Nest you will he asked to type in your address, 
followed by your telephone number. 



As well as using INPUT 

lier, a string to a label, they 
the LET statement: 



10 LET A = 10 
20 LETB = 1000 

30 LET AS = "THIS IS A STRING" 
40 LET B$ = "ABC 123X": REM ■ A CAR NUMBER PLATE. 



100PRINTB/A 
110 PRINT AS 
120 PRINT B$ 



suit! (Remember that 



MULTIPLE STATEMENTS 

On line 40 in the program lines above and after the >. 
"ABC 123X", and before the REMark I placed a coli 
). The purpose of the colon is to separate staten 
which are on the same line, it's as though you ha\ 



i EXTRA IGNORED 

If you did, then by examining the printed output you will 
see that everything th.it iollowed ihe character which 
preceded the comma which you typed has not been 
printed. What this tells us. loosely, is that CBM Basic 
will not accept a comma emplaced within a string, and 
will thus terminate any output including the comma 
onwards. 

Line 40 is a special command, CHRS(147), which tells 
the computer to clear the screen - the same as you did 
when you used the SHIFT key and INST/DEL key. There 
are a lot of numbers we can use within the brackets of 
CHRJ(n) to tell the computer to do many things, 
however, that is for later. 

The computer will create tv 
for variables and constant 

holding strings. 

With strings, Ihe same as variables, the maximum length 
of a label is two characters although more can be used 
lor information purposes. I used NS for the name, this 
could just as easily have been NAMES, however, with 
NA being the significant portion of the label. Note also 
the prefix of S. 

to let the computer know it is dealing with a string of 
characters. 



ANOTHER GLANCE AT VARIABLES 
AND STRINGS 



We are allowed to place as many si 

upon each line so long as they are separated by colons. 

This does have the advantage of freeing up some 

memory, but it often has the disadvantage of making 

lirijgi.im.s more rlilikult to follow, and, more importantly, 

there are some statements which do require a line all to 

themselves. We will discover these particular instances 

as we come to them in the lessons. 

However, to round off multiple statements here is an 

example of multiple statement lines of code: 

10 LET X = 34 : LET Y = 72 : PRINT X : PRINT Y 

20 LET NS = "YOUR NAME" I LET A$ = "YOUR ADDRESS" 

30 INPUT MS : INPUT A1$ : PRINT N1S I PRINT Alt 



OUR FIRST LOOP 

mes it is extremely useful to get the program to run 
ind a loop - as an example of a need for this is a 
y loop, where you wish to slow down the program 
ution for some reason. There are two basic methods 
lable and the first of these is called a FOR...NEXT 



Type NEW then <CLR> (i.e. clear the screen], then type 

in the following program: 

10 PRINT "HELLO" 

20FORX = 1 TO 1000 

23 REM - A DUMMY LINE TO DEMONSTRATE THE 
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LOOP 

30 NEXT X 

4(1 PRINT "WORLD" 
50 END 

When you run thi- program rirst HELLO is pri 
a lengthy delay where, on the following line, ^ 

What we have done here is to set up a variable called X 
and have given il an initial value of 1 . FOR X = 1 ... We 
have also established that the value of X will not 
increment above 1000. ...TO 1000. When the program 
steps through to the line 30, NEXT X, it will check the 
value of X and ii it is not greater than 1000 then it will 
jump backwards to the statement following the FOR ... 
statement, in our case, line 25 which was a REM placed 
there to create a line which actually does nothing of 
importance. In a more complex program she distance 
between the FOR and the NEXT could be quite large with 
several slnl.emenb being executed in between. Let's have 
a look at a simple example of this: 

10 LET AS = "THE VALUE OF X IS" 

20FORX = 1 TO 10 

30 PRINT A$ X 

40 FOR V = 1 TO 1000:NEXT Y 

50 NEXT X 

60 END 



30 LET 1 = 1 + 1 

40 IF I =< 10 THEN 20 
50 PRINT "DONE" 
60 END 

If you run this program it will print the digits from 1 to 

10, followed with DONE. But whal is actually taking 

line 10 initialises a variable labelled I to equal 1. 
line 20 immediately prints its value. 

I by one. 



it has reached a predetermined I 
from the loop. Now if this doe 
FOR.. .NEXT loop, then in essenc 
loop we must determine whal .ir 
iteration. This will require decisio 



it is, except with this 
on to take upon each 



MAKING DECISIONS 



n method of decision making is to use 
the command statements IF...THEN. In other words, IF 
this is true, THEN do somethinp.. olherwiM' do something 
else. For example, START - IF X = 10 THEN X = AND 
END, OTHERWISE X = X + 1 GO BACK TO START. 



r, but si 



ler, delay loop tt 



line -lil evaluates whether I is equal to, or less than, ten 
ithe symbol =< means equal to or less than), and if it is 
wili send the computer back to line 20 (THEN 20 means 
goto 201. The computer will loop between lines 20 and 
■■■HI nnl. ; l the value or I i? greater tivin ion where il will not 
gout line 20, but drop through to line 50, which simply 
prints DONE, and the program terminates. 

Whether we use the FOR... NEXT loop, or a decision 
making branch, IF... THEN will very much depend upon 
the program we are working on. This Is where 
experience and knowledge combine, knowing which 
method best to use, and this you will gain as we progress 
through our subject lessons. 



twill print ten lines, each 
it value of X is. Vou will 
ce one FOR... NEXT loop 



Now if you RUN this program i 

one telling you what the currei 

also observe that we have pla 

inside another, creating t 

is known as 'nesting'. The outer X loop, iterates ten tinier 

printing the message of AS, and the inner Y loop acts as a 

delay, -lowing things down. The outer loop will iterate 

once, then the inner loop will iterate 1000 limes before 

the outer loop iterates again. So the inner loop will 

iterate 10 x 1000 times. 



FINALLY, LET'S GET RID OF LET 

I have been using the wotd LET each time I assigned a 
value, or a siring to a label. Although LET is a keyword, 
il i; optional wiiethei vou wis 1 ' In use il. Sometimes it 
can make the understanding of a program more clear, but 
most I v il | u st uses up a little mure meinorv ind execution 
time. It is up to you whether you wish to use it, but we 
can state: 

■ ( U P 10X = 10 

111,11 20 AS = "LET CO" 

eMt 30A = A+B/C*D 

FIRST = 1: SEC = 2 



SUMMARY FOR PART TWO 

1. In this session we discovered that by using the 
keyword INPUT the computer can request the user to 
enter numbers which can then be used to either initialise 
variables or perform mathematical manipulations upon 



o di,< nvered lhat the c 



mbers and strings ol ,ilph, : ir 



:■ the Incililies of Ihe s 



rtlng the changes which rr 
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4. We looked into ihe INPUT of chancier string-., how 
we can program [lie computer to request information 
such as names and addresses, telephone numbers, &etc, 
by using the prefix S character. We also noted ihe 

limitation of using the comma within a siring: where Ihe 
text following ihe comma will be ignored. 



5. We also noted lhal strings ca 
in length, but, because of Mi 
temporary limited the length !( 






2 r >b i haracler; 



6. Part of this sessions discussion showed that it is also 

pussiblc to initialise number variable's as well as stiings. 
by using the LET keyword, 

7. By using a colon [:) we can separate multiple 
statements an a line, but there are certain restrictions 
when using this option, 

8. We looked at two methods which can be used for 

controlling program loops. The first is the use of the 
FOR... NEXT statement, and the other is by using a 
variable as a counter in conjunction with tin.' dec i sum 
itlF...THEN. 



9. Finally v\ 



nitted. 



ry that the LET 



; ,,pii ( ,i 



That's just about it. Wt apologise for missing out all of 
the above, we hope that it did not confuse you too 
much. Before getting on with this months tutorial 
proper, we have added a little footnote to finish off 
MARCH'S discussion on ARRAYS. 



) fontnr 



I Ihe rl 



ingot 



■f JIT 



We shall now look at methods to control character 
colour, cursor positioning, and formatting. The first two, 
character colour and cursor positioning use a method of 
embedding within test strings the necessary 'shorthand' 
commands to perform such functions. 

Formatting has the use of two possible keywords, 
namely, TAB!) and SPCfJ, we shall deal with these in a 
moment. However, there are other methods for 
positioning the cursor. One of which which uses a 
machine code routine within the npi-rai ; .c.g system know- 
as 'PLOT, and yet another method which will allow us 
to save the current cursor position before we i-ine it to 
another screen location, then retrieve : to move back 
again. We can also use the embeoued iuiso' io-i-oi. 
held in strings which can then be manipulated by 
'cutting up' the strings. We shall deal with these 
methods a little later on in the series 

By using the special graphic kevs on the M wi I .illow us 

to produce vers useful graphic inures, jucn os boxes, oi 
windows within which we can place our test, or borders, 
either plain or fancy, to surround our text, and even quite 
interesting pictures to enhance our screens. 



EMBEDDED COMMANDS 

The thing aboul using emhedrled commands within text 
strings is that I will have to use abbreviations to let you 
know what it is I want you to do. Remember last month 
I told you about pc-rli 'iming the screen i rear by using the 
SHIFT and CLR/HOME keys in conjunction, i.e. 

10 PRINT "[SHIFT CLR/HOMEICLEARING THE SCREEN" 

using this method printed ,i reversed hear! symbol. Here 
follows a list of the abbreviations for the embedded 

commands which I snail be using thniiighrnil Ihe series. 



10DIMNAME$(1ul,5CORESnOI,AA(100),BISi1{l,6),NN$(2,7) 
will separately dimension NAMES - SCORES - AA - BB - 
NN$ 



1MB. Some ol the ; ir f .gram- and program segments in the 
tutorials are also listed on this months disk. It is 
suggested that you do write the smaller segments 
yourself, but it you should lirn'l things a little trickv then 
you can load in from the disk. The programs which ^re 
on the disk will be preceded b\ theii save name just 
before the tutorial listing. These ate BB,EG#<n>, where 
n is the example number. 



COLOUR, FORMAT, AND 
GRAPHICS 



[Cl] 
[CD] 

ICU] 



KEYPRESS REQUIRED 

CRSR LEFT/RIGHT KEY 

SHIFT AND CRSR LEFT/RIGHT KEYS 

CRSR UP/DOWN KEY 

SHIFT AND CRSR UP/DOWN KEYS 



A number following the cursor 
key that particular number of til 
LEFT/RIGHT key five times. 



;. E.G. [CRS] = CRSR 



[HOME] 


CLR/HOME KEY 


[CLR] 


SHIFT AND CLR/HOME KEYS 


[RVSON] 


CTRL AND 9 KEYS 


[RVSOFF] 


CTRL AND KEYS 


[INST] 


INST/DEL KEY 


[DEL] 


SHIFT AND INST/DEl KEYS 


[PI] 


SHIFT AND UP ARROW KEYS 


[LARROW] 


LEFT ARROW KEY 


[UPARROW] 


UP ARROW KEY 


[SPAC] 


SPACE-BAR 
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A number folio 


ving the space bar means press t 


space-bar thai nu 


mher of limes. E.G. [SPAC10] = Spa 


bat ten limes, ere 


iting ten blank spaces. 


COLOURS 




[BLACK] 


CTRL AND 1 KEYS 


[WHITE] 


CTRL AND 2 KEYS 


[RED] 


CTRL AND 3 KEYS 


ICVAN] 


CTRL AND 4 KEYS 


[PURPIE] 


CTRL AND 5 KEYS 


ICREEN] 


CTRL AND 6 KEYS 


[BLUE] 


CTRL AND 7 KEYS 


IVELLOW] 


CTRL AND 8 KEYS 


[ORANGE] 


CBMAND 1 KEYS 


IBROWN] 


CBMAND2 KEYS 


[LRED] 


CBMAND 3 KEYS 


[CREV1I 


CBMAND 4 KEYS 


[GREY2] 


CBM AND S KEYS 


[LGREEN] 


CBMAND 6 KEYS 


[LBLUE] 


CBM AND 7 KEYS 


[GREY3] 


CBM AND 8 KEYS 



GRAPHIC CHARACTERS 



A number following the C/LETTEK OK 5/LLTTLK means 
press the letter kr\ ili.ii pariu ul.ir number of limes. E.G. 
[S/F8] = hold SHIFT down and press the letter F eight 

Using these abbieviatiuris, or mnemonic- (as same like 
to call diem), we can now choose to add colour to our 
printed output, or move the cursor up, down, lefl and 
right, or by using the special graphic symbols create 
some neat graphic effects. Let's have a look al a few 
examples of what I mean. 

BB.EG#1 

5 REM "• COLOUR AND CURSOR CHANGES *** 

10 PRINT"[CLR][LGRF.EN]CLEAR THE SCREEN AND 

COLOURS LIGHT GREEN" 

20 PRINT"[CD4][LRED]THIS TEXT HAS MOVED 

DOWN FOUR LINES" 

30 PRINT"[CU3][GREY3]TEXT HAS CHANCED 

COLOUR AND MOVED UP" 

40 PRINT"[CD4]A MULTICOLORED |LRED]W|WHITE] 

0[CREEN]R[YELLOW]D" 

SO PRINT"[LBLUEHCD2]COLOUR BACK TO 

NORMAL" 



BB.EG#2 

5 REM— A LOOK AT REVERSE VIDEO — 

11) PRlNT"[CLR][CD4][LRED][RVSON][SPAC2]A 

TITLE/MENU BAR[SPAC2][RVSOFF] 

20 PRINT"[WHITE][CD]1. MENU ITEM 1" 

30 PRINT"2. MENU ITEM 2" 

40 PRINT"[CD12][CYAN][RVSON][SPAC]PRESS ANY 

KEY TO QUIT[SPAC][RVSOFF]" 



In I his f'\,iiii!ilH I ii.,vi' '-'in ;■■: k.i en ,i ii.--.... .: (iiiiiijiii! ■.void 
In line SO, namely, GET. Lei us divert our attention for a 
mimee; and examine i h is more- duseiv | .- r ■ ijiramnii.ss 
tend to use this key word quite a lot. 

A method whereby ihe computer is able to detect when 
a user makes a keypress is to employ a system which will 
continually check the keyboard to see if a key has been 
pressed. Obviously ihe compuiei is di 'ins ibis constantly 
from the moment ii is swilched on. However, we can use 
the key word GET to find out what was the very lasl 
keypress a user might have made and then put this 
inrormalion to our own use. Because the keyboard is all 
characters (i.e. letters, numbers, and controls}, then we 
need to use a string variable to store the value of last 
keypress. 

In the program above I chose to use the string variable 
A$. GET will place the lasl key press inlo the variable 
AS. Now if no key has been pressed then AS Is filled 
with the string equivalent of zero, which is referred to as 
a 'null' string. As you know by using quotes allows the 
machine to identity Ihe beginning and ihe ending of a 

String of a single space, and this, "Z", means a string 
which contains only the letter Z. A null string is 
represented thus, "". 

So, line 51) uses GE I and places the result in the variable 
AS. The next command on line 50 is an IF.. .THEN 
decision. If AS = "" THEN 50, in other words if AS is 
null then no key has been pressed so go to line 50 and 
use Gf I again. The program will loop forever on line 50 
until a key has been pressed. Oni e a key is pressed then 
AS will hold a value other than null, therefore, the 
dec is niii argument becomes false and so the ...THEN pan 
of Ihe argument will not be executed which means the 
program will 'drop through' line 50 and continue to 
execute from line 60. 

If you consider the foregoing you will realise that AS Will 
hold the value of the character which was pressed. It 
readily becomes apparent thai you can have a much 
gieatei degree of control over what the user receives 
Irorn what the keypre^ mighl have been, lor example a 
few IF.. .THEN dec isioe.s could determine il the key was a 
"V for Yes, or an "N" for No, or whatever. We will be 
returning to this quile soon. 

Back lo our examples. Let us now look at what can be 

embedded commands for colour and cursor. 

BB.EG#3 

5 REM— GRAPHIC SYMBOLS EXAMPLE — 

1 PRI NT"[CLR] [CD8] [CR7][ BLACK] [S/O] [C/Y24] [S/P]" 
20 PRINT"|CR7|[C/H]|YELLOWJTHI5 COULD BE A 
DIALOGUES LACK] [C/N]" 
30PRINT"[CR7][C/H]|SPAC24][C/N" 
40PRINT"[CR7][C/H][GREEN][SPAC9]BOX...[SPAC9][ 
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BLACK] [C/N]" 

50PRINT"|CR7i[C/H][SPAC24][C/N" 

60PRINT"[CR7][S/t][C/P24][S/«|[LBLUEI" 



fol 



frst sight thi 

owing the a 
jldn'l prove lc 



::,l:,- t . 



a little cryptic, but by 
'ined e '" 



.ich of a hassle. Note also that line 
e 30, therefore, instead of typing in 
line SO simply cursor up to line 30 and replace the 3 with 
a 5 (remember to press return, and lliun move the cursor 
back down the screen to a blank space ready to type in- 
line 60). When you have Implied typing in this evimple 
and have RUN it, then the screen should be cleared and 
a box with the words, THIS COULD BE A DIALOGUE 
BOX... within it should appear onto the screen. 

If you practice using the embedded controls and the 
graphic symbols by simply 'playing around' with them 
using the print command you will soon commit all the 
necessary control- and commands to memory. It really is 



10 PRINT"NAME" TABCJtl) "AMOUNT":PRINT 

20 PRINT"JOHN" TAB(32) "50" 

RUN 

NAME AMOUNT 

JOHN SO 

READY. 

From this example you can see that the tabulation was 
from the start of the line. It counted over both NAME, 
and |OHN. Whereas the SPC command counted from the 
poinl where the cursor was currently situated. You can 
also see that at the end of line 10 I added a second 
PRINT statement on its own. What this achieves is to 
print a carriage return, which gives a row space between 
the line, NAME AMOUNT and the line, |OHN 50. 

10 PRINT"HELLO"TAB(85)"THERE" 



FORMAT WITH TAB AND SPC 

The action of the SPC function is to control the formatting 
of data as either an output to the screen or to a logit .il 
file. However, at this stage we shall only look at the 
screen function. We can tell the computer how many 
spaces we require the cursor to move by enclosing the 
number of space* required '". parenthesis. Tin 1 number or 
the argument [spaces! must be in the range from to 255. 



THERE 
READY. 



That is all for r 



,„,.,_,.rTtirtg Tabulation, Embedded 
Controls, and Graphic keys. You can create your 
homework!!), and simply play around with the thinj 
have covered so far. You cannot harm the r™*™ *"• 
if anything should go wrong with a prog 
create and the system 'bombs' out, simply sw 



computer, and 



RUN 




POKING AND PEEKING 


WE CAN PRINT HERE 


AND THERE 


That subtitle almost sounds as though it could be 


READY. 




exotic Chinese dish! 



From this example you will see that the spaces (10) are 
counted from the end of HERE to the beginning of AND. 
Also in this example you will have noted the use of a 
semi-colon at the end of line 10. This tells the computer 
not to perform a carriage return after it has finished 
priming ihi-' text of line "0. so. therefoic. the next prinl 
statement (line 2iV> will continue priming it's text upon 
the same line. This will indeed prove to be a very useful 

10PR1NT"ONE"SPC(10)"TWO"SPC(8)"THREE" 

RUN 

ONE TWO THREE 



The action of the TAB function, allhough it may at first 
seem the same, moves the cursor to a relative SPC move 
position on the screen given by a numeric argument in 
parenthesis but this time starting at the left-most position 
of the current screen line. Once again the numeric 
argument is in the range from o to 255. 



To POKE means to place a value into a memory location. 
To l' J ff-K means to have a look at a meitnvy location and 
find out what value il may contain. Of course to either 
POKE or PEEK a memory location will require you to 
know the address nf the memory location you wish to 
deal with. 

Earlier I explained that I Fn_- i.omputer Iwis b'i.S.id bytes of 
memory, each byii- representing a memory location, and, 
each byte can only hold a number from to 255. The 
computers memory i? 'mapped' -nro various areas and 
segments for better memory management, There are 
areas in this map which will prove to be of great 
importance to you as you establish you programming 
skills. Lili'ic i . nets iiiil a very genera ;ised memory map. 

Il you have the Commodore fi-l '-.ser Ma ilea I which came 
with the Commodore when il was purchased, then by 
turning to page 143 you will rind Appendix E, which is a 
list of the SCREEN DISPLAY CODES. For the time being 
we shall ignore SET 2 and concentrate on SET 1. You 
will see that a character is displayed under the SET 1 
heading and a number under the POKE heading. What 
all of this means, in actual fact, is lhal if we POKE the 
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letter 



of the character we 
n address of the screi 

will be reproduced o 



) the st 



Now if you turn to page 149 of the manual you will 
discover a pictorial representation of the screen which 
lists all the memory addresses. You can see that the 
screen is divided ink) iii()i i rh, mirier squares in a matrix 
ol 4(1 squares hnri7nntiillv by J.~ squares vertically. We 
usually refer to this as X (columns - 40) by Y (tows - 25). 
The start address, commonly referred to as the Screen 
Base Address is memory location 1024. Study the screen 
memory map on page 149 for a moment and all of this 
becomes quite clear. 



A = 128+1 =129. 



POKING COLOUR 

The screen we have just been looking at is the character 
screen. To use colour changes we must now access 
another si rutin, this is located in a different part of the 
Mi-niijry Map. The Lo.uur Mcninn. Map lor screen) Base 
Address is Inciter! ,jt 55296. Once again [his is a matrix 
of 40 x 25 squares (1000), and you will find a pictorial 
representation of this located on page 150 of the User 
Manual. Table 2. lists the values needed to POKE a 
i olour into Ihe Colour Map. So: 



So n 



i the 



When you run this you will see that the letter A has been 
printed into the first character square. So, the POKE 
statement is saying to the computer take the value of I, 
which happens to be the screen code for the letter A, and 
place it into the 1,024th byte in the computer's memory. 
Nothing could be more simple, eh? 

We can, using that which we have so far learned, do 
much more than this, let's print a whole siring of the 
leiier A Hprp we will need a loop to iterate around our 
Try this: 



10 FOKX = TO 999 
20 POKE 1024 + X,1 
30 NEXT X 



When you run this program you will see t 
rapidly fill the screen with letter A's. You 
line 20 we simply add the value of X to 
incrementing it by one character square e 



POKING SCREEN AND BORDER 
COLOURS 



Naturally we do not wish 


o confine ourselves to the 


Start-up screen and borde 


colours all the time. We 


might like to change the 


screen and border colour 


quite often in a program 


o add to the aesthetics of 


things. We might even 


vish to use the border to 


indicate something by al 




colours. 





1024, thereby 



There are two memory locations which will alow i 
to do such things as I haye just described. They an 
address 53280 for the border colour and addre! 
53281 for the screen colour. Using the colour valut 
as defined in Table 2. we can now POKE a colour 1 
one, or both of these locations, 

1 POKE 53280,0 : POKE 53281,0 



With slight iiiodilicilion we can use the same principle 
to actually list the entire set of the characters of SET 1 . 
Clear the screen and type in the follow hijj short [irogr.im. 

10 PRINT"[CER][CDB]" 
20FORX = 0TO25S 
30 POKE 1024 + X,X 
40 NEXT X 



20 FOR X = TO 64 : POKE 53280.X : NEXT X 

and the border will cycle through all 16 color 
times. Useful if you need to catch the attentioi 
user of your program. 



line 10 is there? 

After you have RUN this program you will see all the 
possible characters i25h) of the set printed on the screen. 
The first 128 characters are in normal video and the ne.it 
128 characters are rdenli< al except they are the reversed 
yideo characters. This tells you thai when you actually 
use the RVS/ON command the computer simply adds the 
value of 128 to the character values in the character 
string of the PRINT statement. I.E. the letter A = 1 and the 



?en colour in conjunction with character 
>ring your screens alive and make even 



LOOKING AT BYTES - PEEKING 

So far we have only POKEd values into bytes, but nov 
we shall look at PEEKing bytes and how this can assi£ 
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.Mil 






a Ihe PEEK 



wish lo look into a memory |i 
akn- is being held (heir We 
or keyword. We must enclose the addres: 
; brackets. For example, PRINT PEEK(5328G) wil 
the current colour of the border. Amending thi 
pie border cycle above we could interrupt thi 
on any given colour and print a message; 



20 FOR X = TO 64 : POKE 53280.X 

30 IF PEEK(53280)=247 THEN PRINT'YELLOW" 

40 NEXT X 



10 PRINT"[CLR] PLEASE USE NO PUNCTUATION" 

20 INPUT"NAME PLEASE";N$ 

30 INPLTTADDRESS PLEASE";AS 

40 PRINT"[CLR]F1 = NAME" 

50PRINT"F3 = ADDRE5S" 

60PRINT"F5=QUIT" 

70 K= PEEK(197) 

B0 IF K = 64 THEN 70 

90IFK = 4THEN PRINT N$ 

100 IFK = 5THEN PRINT A$ 

120IFK = 6THEN END 

130 GOTO 70 



used the 



You will quickly spot thi 
instead of 7. Why? 

Remember, .i hvte is eight bits, m« **>tx which is 
four low bits and four high bits looking from right to 
left. The four low bits can be in the range from to 
15, and the four high bits can be in the range from 16 
to 240. Without going into the reason just why, the 
high four bits are almost always set to 240, no matter 
what number you may poke into the byte. For 
example you could POKE 53280,129 ■ the byte would 
look like this, 1000 0001, but faster than you ran say 
"BLA" the byte will be changed to 1111 0001, which 
means the colour of the border will be white, because 
the computer only uses the low order bits - the righl- 
most four bits. After saying all that what this means is 
if you want to PEEK the border or screen colours 
within a decisional IF.. .THEN situation, remember to 
add 240 to the number of the colour you are looking 
for. Phewl 

Actually this is nol good programming! Because we 
only seek a number in ihe range to 15 we should 
perform what is called a logical AND (the code would 
look like this - PEEK(53280)AND15). which isolates 
and reads only the four low bits of the byte. However, 
this is racing ahead of ourselves on our learning curve. 
But we will return to this subject. 

There is a very useful memory location at 197 (see 
Table 1. ZERO PACE)- This location has been set 
aside by the operating system to use as a storage byte 
for the last keypress a user may have made. In the 
February 1491 edition of CDU an article appeared 
entitled THE 64s KEYBOARD, if you refer 10 this 
article there is a complete descriplion of this function, 
but, more importantly to us at the moment, there is a 
table within the article which outlines the numerical 
value held in location 197 and its key equivalent it hey 
are not the same as screen codes). If you plan to use 
this location within your programs (and I'm sure you 
will eventually), you would be well advised to keep 
the table for handy reference. 

So, how do we use location 197? Let us write a small 
program which will test for key input and then execute 
nt when it receives the correct key: 



BB.EG#4 

5 REM — A PEEK EXAMPLE *' 



When you RUN this program you will be prompted to 
lue of 147 enter first your name and &— - 
which by pressing J limciior 



ogram you will be prompted to 
and then your address. After 
inctlon key you will either print 
ss, or Quit. The thing to note 

■ input st, j If men I ,is opposed to 



.._. _r Addr . 
about this type of user input statement as opposed lo 
the GET statement we used earlier is that it repeats. 
This can prove a useful facility in many cases, but we 
shall be discussing user interface systems in much 
more detail laler. the important point was to enable 
us too look at another form of PEEK. 

If vou can't, for the moment, by your hands on the 



10K = PEEK(197) 
20 PRINT K 
30 GOTO 10 

If you hold any key down it will keep on repealing, 
just make a note of the number and the corresponding 
key. To stop the program simply press the RUN/STOP 



SPRITES AND SOUNDS 

We all know of the amazing capability of the 
Commodore 64 in it's use of Sprites (also know as 
Movable Object Blocks, MOKsl. „ind Sounds (whether 
special sound eliects or music). To enable us to use 
these facilities lo their mil potential we will need to 
constantly POKE and PEEK values lo and from the 
various areas of memory where the Sprite and Sound 
information is stored. We shall be covering these 
capabilities later in the series. 



BEFORE WE CONCLUDE 

I would like to draw your attention to page 146, 
Appendix F, of the User Manual. Here are listed the 
characters from the character set once more, but a 
quick observation will soon tell you that many of the 
numerical values are modi different to those irom the 
Screen Display Codes on page 143. The Screen 
Display Codes are Commodore's own, and are very 
useful when you want to POKE characters to the 
screen area - POKEing does have a lot of advantages 
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over PRINTing as we shall soon come to see. 
However, there are other aspecfs where PRINTing h^5 



TABLE 1. 

A GENERALISED MEMORY MAP OF THE C64. 






? that 



appear to be emply, rrulh is they are not, and 
they do have functions which we will eventually come 
lo know. You will also see lhar there are many other 
'things' next to Ihe number which do not seem lo be 
characters, for example 14 = switch lo lower case, 8 = 
disable the shift key and the CBM key. 

The abbreviation ASCII means American Standard 
Code for Information Interchange. It is a standard 
character ennjdini; system which is now iiM-:d by the 
;.;i(-Mt majority of i omputers. 

We can use CHRS to convert an ASCII code into its 

lit 1 live-' en (I ,ind 2~>:> and Inn em.losed in parenthesis. 

10 PRINT CHR$(65) : REM ASCII FOR A = 65, 
THEREFORE THIS COMMAND WILL PRINT THE 
CHARACTER A 

1 AS = CHR$(1 3) : REM 1 3 = RETURN KEY 

10 PRINT CHR$(147) : REM CLEAR THE SCREEN 



10 GET AS: IF AS = ""THEN 10 

20 IF AS = CHR$(160I THEN PRINT" SPACE BAR WAS 

PRESSED" 

30 IF AS = CHR$<133) THEN PRINT" KEY Fl WAS 

PRESSED" 

40 IF AS = "L" THEN PRINT CHRS(14): REM IF 'L' 

PRESSED SWITCH TO LOWER CASE 

30 IF AS = "U" THEN PRINT CHRS(142): REM IF 'U' 

PRESSED SWITCH TO UPPER CASE 

60 IF AS = CHRSI134] THEN PRINT CHRS(147):REM 

KEY F3 CLEARS SCREEN 

70 GOTO 10 

We shall be dealing with these codes in much more 
detail a little later on in the series ' 
construct more substantial programs. 

NEXT MONTH 

Next issue we shall be exploring the world of 

numbers and how we can 

Ihern in simulations and ev 

We shall also return to slrings and h, 

how easily we can cut them up 

pieces. Further to this we shall 

digital clock jusl for fun. 

So until next month, happy finger tapping. 
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ON THE DISK 



Yet another Raster utility hits the streets. (Doesn't anyone program anything else these days 
DAVID BRYSON 



.Winy utilities nm\ an-' usually repeals of tht- sji'iii' utility commands, lb memiin^ a block, press "1" al [he star! 

some lima ago, but better [or perish (he thought, worse!) of the block and "2" at the end. You do not see anything 

This is vi hv I Her iri'-'< I In '<■ iir.cr.l 1 1 1 1 ■ ,-vlnvl ih- I . -_■ |>| ji ■ ■ ■ i n ;^ ,vh< n du'ii:: tin-- and nliv nii-lv. vol. mii^l 

name is "RASTER MASTER" With this utility, you can press "2" further clown than "1". Once you haye 

make up colour data for raster bars, and presentation of grabbed a block, you car. duplicate il al another position 

your own demos and games would be both easier and by pressing "3", or if you want a mirror-image of the 

better. RASTER MASTER works by changing the colour block press BACKARROW. This is very lime-saying when 

on every raster line of the screen. Before starting, if you making colour bars lhal are symmetrical. 
have not come across the term "RASTER", if is a VERY 

fast beam that draws Ihe picture fn a television, and THE COLOUR TABLE 
travels across the screen, starting from the lop and 

finishing at ihe bottom. Tne co |( lur lal j| e j s a stretch of memory which holds all 

the colours for each raster line. Il is in ihe usual formal, 

__-_—,.,- CTADTCn i-e. one byte per colour, and can be 192 bytes maximum 

GETTING STARTED (wWch m ' ean ^ m , asler ljnei which is ' he mosl you 

can display on Ihe editor screen) The program actually 

When you first load RASTER MASTER and press a key manipulates 25& lines, as you can see when you try 

you are presented with a virtually blank screen - but inserting colours off the screen, and deleting them back 

don't despair! Pressing "E7" will take you into the help on again. The colour table can be saved out when on 

screen, and you can immediately absorb information the help screen and then be loaded into a demo or a 

(here if you don'l like reading instructions. The reason game to be used - in fact, you could use it wilh Andy 

why the screen is virtually blank is because no colour Partridges famous raster bars routine, featured in an 

dala is in memory, therefore to see example colour bars, earlier issue of CDU. but more aboul this later. The end 

press "L" on the HELP SCREEN to load a file. Type in the of the colour table is signified by a thin while line, which 

filename "DEMO.COL" and it will load the file from you can move about wilh ihe keys T" and "L". When 

disk. There is also more example files called you load a colour table, there is no need to set this, as 

"DEMD2.COL" and "DEMO.i.COL" which you can load the program does il automatically. This is why, when 

in a similar manner. If you do not wish to load or save a saving a colour table, you should always set the white 

file, press any other key lo exit, although it is advisable line to the correct place, 
that you press "FT" again, as pies^inj; another key might 

activate a function accidentally. USING IT IN YOUR OWN 

PROGRAMS 

USING THE EDITOR Qn [he di5k „ a sma|| examp , e program 

, L . . ,_, _,. , ("RASTERBARS.BAS) whtcfl shows how you can display 

When yon have done this the screen .„„„l„ ,!,.,,! ,s lot, bm . ow „ e , en J ^ 

of p,etty colon, h.„s. \nu , .In odd the , oloot. h, „,,,„„ in(l , r „ ^ |mv , ,, „,. mKm code 

niovine. o f ) .and down with the cntsot kevs a, jre-sins; ,. |p whi ,. h (Mmi ;, v . ,|ie colour hats called 

■A" and -S- lo mo.e thiouph ihe colon,, „l the me lhal u„ TFRBAFS MC ;„,, ,,. ,,. ,,,j," ur .,.,,., which ,„„ 

*'""■'■■ :,"""'"> I, 1 ", " ' I i Remembe, 

utossin. RETURN a lew times he should .■ toll ihe fc ^ M ^ , , ., „., ,, , „„„ ^ 

col ™ u l »'■»"..« al all tlependiiif „-., tram .,,,, ,„,„,„ ,,,,,,, ,. ,„ s ,., n ,|., rd „„ m . ,|,e,e(ore It is 

dTla'fteThde scr«n° ", iTwoo'in', So fa"! h! P °" ' "" , °"' °" " »'"" ! ' " '"'*" " 

11I1I1-I1 .il r 1 1 r ■ l,-'tt-h.-iiiif r-e,- 1<- ... Vr ti i .v-: H-|id.a|-,l,, I h r ■ III in I. t^ ' .".!. _ . .-.'... , P ' ■ 



ghuli at thi.' left-hand edge. Vnu (.an disable the borders 



ising "SYS 52224" but before it is ready tc 



if you don't like it or think it looks better by pressing the mu ^ te| >j |ho progfan| now volj ,,„, 
" B ke V- displayed. The length of the colour data is important 

«. ««„ M ........» (which is displayed IN HEXADECIMAL on the help 

BLOCK COMMANDS screen of Ihe RASTER MASTER editor) as well as what 

vertical line you want your colour bars to start, you can 
One of Ihe powerful commands in the editor is ihe block choose any line ranging from $32 (50 decimal, lop of 



■ 
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display) to SF9 (249 decimal, bottom of display) in the 




■JoiviKf- ■'■■(; ri1rirv.il program. It 
pages in an attractive and simple 
New pages can be created to add to those already 
ible. This is done umns> iIil oii-lini? Editor. The user 
ise 64-Tel in whatever way he or she w 
pie, the pages could be used to hold vital CCSE 
ly the pages may be used far 
addresses as well as hints and lips lor users that send 
disks to each other. The 64-Tel service is like TeleH 
What's more, it has the added touch of being n 
interactive and personal. Its simplicity in use 
both the novice and expert pragrami 



ON THE DISK 



You will be greelod Willi ,i simple 64-TEL logo. At this 
stage the program prompts vuu In enter the present lime. 
First enter ihe hours followed by the minutes then 
seconds. The inputs must hi' Inn digits. i.Eg: 8 o'clock 
would be 08). Enter the current date in the same way. 
When you have finished there will be some disk 
.accessing as the index page is listed. You are now in a 
'Teletext' service. Pages from li)i)-l t -> < ) can be entered by 
the user. The requeued page will be loaded from tlisk. 
Note that the index page reside, in memory for prompt 
access. This page appears if page 1(10 or an unavailable 
page is requested. All pages available on the disk are 
found by pressing 'P'. that is basically how to use the 
program. Some other opera Nona I keys are given below. 



FLASHING CHARACTERS 

I lashing characters can emphasise parts of the screen, 
maling them immediately noticeable. Introduce FLASH 
CI IARS in the lullow-mg way. design all of your page first 
and copy it to RAM (FB). Now put the Editor into flash 
mode (F5) (You will notice this as the cursor slowly 
Hashes). Now move the cursor to tin: diameter you Want 
to flash. Put a SPACE in it's place (In other words, hit the 
space bar). Set Ihe text colour of the flashing characters 
beforehand using the standard CTRL/CBM 1-8, with all 
the flashing char. niters introduced, Use F6 to save the 
page to disk. That's it!! 



i isgoii 



, tllN 






<e 64-Tel. (Do not use RUN STOP/RESTORE), 
SPACEBAR Reveal stop. It's use is to show up hidden 
characters. Useful lor answers 1« jokes anil questions!! I 
have also activated the external voice of the SID chip. 
This will allow you to listen to an external sound source 
whilst reading the 64-TEL pages. I find that some light 
jazz music accompanies my viewing quite well I 

THE EDITOR 

Creating your own, or editing esisting pages is a very simple 
process. When you use F1 to enter the Editor from 64-TEL, a 
cursur will appear in the r.ip l,-n hand « if ihe screen. You can 
now Edit the screen in anyway you wish. The available 
editing area is -It)" 1 > i ha ratters, i Ihe iup screen line is used 
by 64-TEL-and the bottom screen line displays function 
messages). All Ihe < i introl slop, aie available. Therefore you 
can use the cursor keys to position the cursor. The SHIFT 
plus CLEAR/HOME keys to clear the screen, maybe CTRL 
..■■I : ,r:.'... -l-.--.li., !■:■ I c I'. f. : . .,■■.-. irn. : i 1 1 ■ : r i < . 1 1 ■- .a. 

also available/ 

Fl - Return to 64-TEL. 

F2 - Sets page ■ H..ic kgrounn) colour. (. onlinuous pressing of 

F2 will scroll through all 16 colours. 

F3 - Toggle UPPER/LOWER case. Use F3 instead of 

CBM/SI il I T to proper I v reg.sler ihe type case of the page. 

F4 - Remove a page from disk. The page iciimvcd is I lie one 

currently specified by the pane number. Use I" before using 

F4. 

F5 - Toggle FLASH/REVEAL mode. Flash mode is indicated 

by the cursor flashing. Entering the Edilor from 64-TEL 

aulomalii ally sets it to reveal mode. 

F6 ■ Save a page- to disk. The saved page is labelled with the 

current page number. Use F7 beforehand. 

F7- Enter the new page number. A 'V will appear in the tup 

left of the screen, just enter two more digits. 

FB - Copy SCREEN to RAM. (More on this later). 

CBM - This is the Editors reveal key. Ihe spai/ehai is already- 
being used lor Editing purposes. CBM will let you .see bow 
your reveal CLR-UP is working, 

When you have finished designing your page ami are ready 
to save it to disk, press FB. (This is essenlial otherwise ihe 
page you later on load hack from disk may look quite 
different:'. Next, press Eh to save your page. Continue editing 
or creating new pages, or return to 64-TEL through Fl, 




REVEAL MODE 

Reveal mode wink- in the same way as above, except 
lhat the characters are hidden and do not appear until 
you press CBM in the Editor, or SPACE in 64-TEL. Follow 
the same procedure as above for the FLA5H characters, 
but remember to have the Editor in REVEAL mode. 



A FRESH START 



1. Insert a new formatted diss i mo ihe drive, 

2. Use the Editor to remove all existing pages. Then from 
Basic use the command OPEN15,B,I5,"SO:B":CLOSE15 
to scratch the PBAM file. (The PBAM file is a page block 
availability map, like the 1541 's BAM, which the 'P' 
operation in 64-TEL uses the available pages). 

When 64-TEL is then RE-RUN, a disk error will occur as 
the program tries to load the index page. Ignore this and 
stait creating your pages. Il is a good idea lo write your 
index page first, this can always be Edited later, but its 
initial presence is to stop disk error occurring next lime 
64-TEL is used. If you forget which pages you have 
created, use the key 'P' operation in 64-TEL. 



ON THE DISK 




HOW IT WORKS 

An assembler listing, M/C 64-TEL, is provided i 

disk. The program is lull iii.it hi no code and is intet 
with an IRQ interrupt routine. (Which handles the clock 
display update and the dual background colour screen). 
The program consisls of two m.iin p.irts, 64-TLL .ind the 
EDITOR. 64-TEL handles PAGE and PBAM disk loading 
whilst the EDITOR deals with the page saving. The 64's 
memory is used in the following way. 



routine. If a viewed page has a non-black background 
colour, you will notice 2 RASTER screen splits. One 
below the top screen line, the other above the bottom 
screen line. Between these 2 RASTER splits a different 
colour background ran be used instead of the black line 
thai appears on the top and bottom screen lines. 
I'LASI l/REVEAL mode works by altering VICMEM address 
SD018. 1 his stales where the screen display will start. 
The IRQ routine will ser SD01B to display the screen at 
$0400 or S0B0O. The IRQ routine operating from a 
RASTER IRQ runs at KWHz. The keyboard scan routine 
in ROM is called on every other IRQ call. Therefore it 
runs at normal pace. The operating systems normal 
interrupt mechanism at address SDCOD was disabled to 
avoir! ,inv possible screen flicker. 

64-TEL is situated just below Basic ROM, Area SC00O- 
SCFFF is used too frequently, and besides, putting 64-TEL in 
this area would have made il r.< ompatible with the 



$AOO0-$FFFF 


Kernal ROM, I/O, Basic etc. 


S'!(l(.!i) S'lACIO ■ 64-TEL program. 


S1°U0-$8FFF-RAM. 


51600-$1BFF 


PRAMlUsed ares S IH64-$1BC8). 


S1400-S17FF 


Index page colour. 


S1000-S13FF 


Index page text. 


S0CO0-SD9FF 


Current page colour. 


S0800-S0BFF 


(. urrenl page text. 


S04()0-$07FF 


Text screen display. 


10000 S03FF - Operating system and Basic ROM use. 


The portion loaded and saved to disk each time is 


memory area $0800-S1000. The contents of a currenl 


page colour area reflect somewhat colour ROM at 


SLJSiln-SDBfh Mil' , urrenl page text is 'identical' to 


screen RAM, J 


0400-SOBOO. 



PAGE BLOCK AVAILABILITY MAP 



Now you can use 64-TEL in conjunction with any Basic 
program that you may be developing or running. For 
example, instead of thumbing through your manual just run 
64-TEL (SYS36H64) and load up thai help page from disk- 
When you have finished, exit from 64-TEL and continue 
with whatever you was doing previously. Your Basic code 
can use up to about 3 UK before il starts to corrupt 64-TEL 
While in Basic you can see thai 64-TEL is still active 
ihi'iuch [he i "iriiiLiiiuslv updated clock. You can remove 
this by hilling RUN/STOP and RESTORE. 



FINALLY 

I have included a simple demo program t 
64-TEL can be used with a Basic program. If you havi 
followed ihe commands above (POKE44 etci, ihen load thi 
demo program and run it. Your own programs should nc 
alter Ihe IRQ vector at SIB14-SH315 or your program wil 
hang up. WARNING, 64-TEL handles no disk errors 
Therefore it is not failsafe. However, if all the guide line 
are followed properlv ilien •■vx-". lliin^ should be Okay. 






The PBAM works in 

(100-199). 

A = PEEK($1800+X). 

SFF page available. 



ihe following way, X = Page lx 
f A = U ihen page not available. 



iii/EH/Si.ifSFM - S(r<-en background-. 
S(l^i:')/si-]|3[g - rlash/Revcal mode. 
SorE.A/SOBEA - Upper/Lowercase rr 
S07EB/SOBEB - Page next. 
SUBE8-S0BEB have Ihe same conterT 

Locations $07EH and $07E4 are u 



as S07EB-S07EB. 

?d by the interrupt 
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Our tutorial into Machine Code programming continues, by ] Simpson. 



"A series of lessons designed for ihe beginner to enter the LINhS BO to 100 are the three memory locations si 
world of machine code programming on the commodore for variable dala storage. 

' "~ ~ian said, and lhat's exactly what this 



JSOftU 



iak hopes to bring you. 



NE 110 is the assembler directin 



le assembly. 



Within a pru'.-um whit h iequired the audition of the two 
PART TWO - EIGHT-BIT ADDITION b ^ es ' VALUEI and VALUE2, would be the necessary code 

which would place the values required into these two dala 
Last month we constructed (albeit rather clumsily] an b^ 5 read V '°< compulation (we shall look at ihis more 
eight-bit addition rouline. We shall now construct a closely when we start discussing subroutines). 
modified version of an addition rouline. 



- = $C0OO 

ADDITION LDA VALUEI 



EIGHT-BIT SUBTRACTION 



50 


ADCVALUE2 










60 


5TASUM 












70 


RTS 






10 


• - scoot 




BO VALUEI 


BYT 20 






20 






90 VALUE2 


BYT 20 






30 


SUBTRACT LDA 


100 SUM 


BYT0 






40 




SEC 


110 END 








SO 
60 
70 




SHC VALUE2 

STASUM 

RTS 


LINE 10 this line 


organises where in 


memory 


the routine 


ao 


VALUEI 


BYT 50 


will locale from 


If Ihis was a sub 




ailed on a 


go 


VALUE2 


BYT 40 


regular basis from within a program 


then this 


line would 


100 


SUM 


BYT0 


be omitted. 








no 


END 





LINE 30 starts wilh our routine label called, ADDITION 
and (he first mnemonic instrueliim IDA tells the processor 
to load the Ac wilh the value held in the memory byte 
labelled VALUEI. If this was a subroutine then it is the 
label, ADDITION, which would be called (more about 
calling subroutines later in the series). 



LINE 40 c 



:> be s. 



if the 



LINE 50 adds the value of the memory byte, VALUE2. plus 
the value of the carry bit (in ihis case 0, because we 
cleared it earlier), id the contents of the Ac (which held the 
value of VALUEI). 



As you can easily see, there is mil ,i gre.il deal or" difference 
between the two routines, ADDITION and SDBTRACT. 
The dilierences. apart from the values held in the variable 
data bytes, is confined 10 Lines 40 and 50. 

LINE 40 this instruclion is the opposite of CLC, in that SEC 
means SEI the Carry. In other words the carry bit (flag) is 



LINE 50 Instead of adding wilh carry we now SuBlract 
with Carry. This allows to subtract from the Ac the data at 
the specified address without a borrow. 

In our example we first loaded the Ac wilh the contents of 
VAI UE I (50). We (hen sulitrac led the contents of VALUE2 
1401 from the Ac. And stored the result in SUM (10). 
During the subtraction process we used the carry flag to 
test for an underflow, if the result of Ihe subtraction had 
been less than zero, then the carry flag would have 
become clear. 
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Understanding the lull imphr.ilions of using Ihe Carry will 
become? more clear when we look at 16 bh addition .inrl 
subtraction. 



SIXTEEN-B1T ADDITION 

An elghr-bit addition will only allow the addition of 
n..nl» ■• «i;hin the range ol I) k.i 2 to. lor mutt pijctii a I 
c. t is necessary to use 'mulli-prei ision' and to 

a lumbers which use sixteen bits or more. I shall 

denon strait' addition on 16-bits, but Ihey can readily be 
ev< -If.u. 24, 32 or more bits. We always use multiples 
01 eight-bits or a byte. Check this example: 



ADDITION 


LDA VAL1 




CLC 




ADC VAL2 




STA SUM 




LDAVAL1+1 




ADC VAL2+1 




STASUM+1 




RTS 


VAL1 


BYT^.55,160 


VAL2 


BYT 237,46 


SUM 


BYT 0,0 


END 





It we now look at the 1 6-bil addition program you will see 
that lines 1 to 40 are just the same as in the H-bil addition 
program, however when we add the two Hi-bytes of 
VAL1+1 and VAL2+1, we did not precede the addition 
with a CLC instruction (we only use CLC at the beginning 
of an addition). This means we add together the two Hi- 
byte values plus the value of the carry. In the case of our 
addition this is what took place: 

When VAL2 was added it took the value held in the Ac 
(taken from VALI) which took it beyond the range of a 
hyte,255. This resulted in thecarry bit being set (1). Now 
the carry will represent 256 to be added to the Hi-byte, or 
adding 1 to bit in the Hi-bvte (which has the column 
value of 256). The balance, 236, which was left in the Ac 
is then stored in SUM1 at line 40. Then lines 50 to 70 
added together the values held in VAL1+1, VAL2+1, plus 
the carry. We know the carry bit was set, so we carry over 
256 to be added to the result of VALU1 and VAL2+1 . 
Here is a graphic example of what took place: 

(LOW BYTE) 



120 

First of all lei us examine the numbers we are adding 
together: The first pair of numbers held in the two bytes of 
VALI and VAL1 + 1 represent 41 215 ($A0FF). The second 
pair of numbers held in VAL2 and VAL2 + 1 represent 
12013 ($2EEDt. We store Ihe low eight-bits of the 16-bit 
number in the first byte, iollowed by the high eighl-bils in 
the second byte. 

You probably I. now that it is si, unhid to store a large value 
in the Low/higli bvle irwmula but if you are unsure just 
how I came to arrive at 255 (la), 160 (hi) VAL1, and 237 
do), 46 (hi) VAL2 I will explain. To calculate the high and 
low bytes of a I 6-bit number, lh.it is a number in the range 
of to 6553b, we must first find the hi-byte. "I his is simply- 
done by dividing the 16-bit number by 256. and ignoring 
any fractional parts, to obtain the lu-bylc we then subtract 
ihe hi-byte from the original number and multiply the 
result by 256. A simple line of BASIC code will do this for 



VALU1 = 160 
+VAL2+1 = 46 
♦CARRY = 1 



%1110 1100 CARRY = I 
iNLTKLSr.NTING2.5t>) 
- CARRY 256 



%10100000 
%0010 1110 

%0(XHM)OG1 (The first c< 
represents 256) 



10 NU = <NUMBER TO SI'I IF>:HI = I NTCN Li/2561: LO = 
NU-INT(HIP256 

Most good assemblers will have same form of number 
conversion command and if you convert the decimal 
number into its he\ equivalent then it is simple to split the 
number into Hi/La bytes (e.g. SA0FF = JA0 and SFF. 
S2EED = $2E and $ED), this would then be incorporated 
into your code- using ,i suitable pseudo-op. 

90VAL1 BYT$FF,SA0 

or il your assembler uses the psnrdo-op, hex 
100VAL2 HEXED21 



SIXTEEN-BIT SUBTRACTION 



SUBTRACT 


LDA VALI 




SEC 




SBC VAL2 




STA SUM 




LDA VALI + 1 




SBC VAL2+1 




STASUM+1 




RTS. 


VALI 


BYT JFF.SAO 


VAL2 


BYTSED.S2E 


SUM 


BYT $00,$00 


END 





PROGRAMMING 



Subtraction is the reverse of addition. We SEt Ihe Carry to 
one at the start of Ihe operation, and ii ihe result of the lo- 
byte becomes a minus number then ihe ?." ..i r ry is i leared 
and thus the la-byte would have borrowed from the hi- 
byte (the value of 255). The result would be caned when 
the hi-byte is calculated because we have borrowed the 
least wnilii.ini bit (the righi ■ most bill from the hi-byte 
during the calculation. If the result of the lo-byte 
subtraction did not underflow, then the carry would 
remain set which would indicate a "no burrow" condition. 
Study the two programs, arklilimi and subtraction until you 
are familiar with them. Try using different values, and 
stepping through each line of code with a paper and 
pencil noting how the changes occur (tracing, or single 
stopping, on paper is explained more fully towards Ihe end 
of this months article). 



MULTIPLICATION 
(GETTING TRICKIER) 



The multiplic 
complex. Fo 
they omitted 



of binary numbers is somewhat n 
ions that only Commodore will ki 

perform either multiplica 



60 MULTIPLY 

70 LSR MPK ; SHIFT MULTIPLIER SIGHT 

80 BCCNOADD ; TEST CARRY, IF CLEAR NO 

ADDITION SO BRANCH 
90 IDA RES ; LOAD Ac WITH LO-BYTE OF 

RESULT 
1 00 CLC ; PREPARATION TO ADD 

110 ADCMPD ; ADD MULTIPLICAND TO 

RESULT 
1 20 STA RES ; NOW SAVE LO-BYTE OF RESULT 
130 LDA RES+1; ADD REST OF SHIFTED 

MULTIPLICAND (HI-BYTE) 
1 40 ADC TMP ; ADD TEMPORARY DATA 

BYTE 

150 STARES+1 ; SAVE HI-BYTE OF RESULT 
160 NOADD 

170 ASLMPD ; LEFT SHIFT MULTIPLICAND 
180 ROLTMP ; LEFT SHIFT AND SAVE BIT 
190 DEX ; DECREMENTTHE COUNTER 

200 BNE MULTIPLY ; IF NOT FINISHED DO IT 
AGAIN 
RT5 



210 

220 ; 

230 TMP BYT 



It is not necessary for me to explain how we multiply two 
numbers in decimal notation, we all learned this at school. 
The method for multi plying iwo binary numbers is exactly 
the same. Let us multiply 5 \ 3: 



101 Partial Prod uc 



The multiplication is performed ijy ■nultiplvir,,: the right-most 
digit of Ihe Multiplicand b\ the Multiplier, llicn one multiplier 
the nt'M digit and so on. We olisct the digits to Ihe lull by op- 
position. Or, equivalently we could say that the partial 
product had been 'shifted' one position to the righi lielore 

In order to perform multiplication the computer will operaie 

the same as we did above. It will 'shift' each line one place to 

the right then add logclhei all oi the lines. However, because 

we are dealing with, a full bvle, eight bits, then the computer 

must shift all eight lines, or eight 'shifts'. 

Here is a routine to multiply two eight bit numbers (8*8 

multiply). 

10INIT LDA#I 



RES 


BYT 0,0 


MPD 


BYT 5 


MPR 


BYT 3 


END 





270 

Because we are doing eight-bit multi pi i< ntion we will have 
to test each bit of the multiplier (MPR), but unfortunately 
ihere is no instruction with which we can sequentially test 
the bits. It is only the bits (flags! in the status register (SR) 
which can conveniently be tested. This is a limitation of 
mosl microprocessors, and as a resell u this limitation il 
will be necessary to shift the byte and test the bit. What 
actually occurs when shifting is that every bit in the byte 
will move right or left by one position. The bit which is 
shifted out of the byte, or 'falls' of the end, is placed into 
the carry bit of the SR. Fig 1 demonstrates the 'shift' (you 
will note thai the figure demonstrates the left shift, or ASL, 
to study a right shift, or LSR, fhen simply reverse the 
direclion of (he arrows). There ate ditieient possibilities 
depending on the shifted 'bit' but more of this will be 
discussed later. 

1 fowever, since we need to tesl each oi" the eight bits of the 
Multiplier, ami since we cm easily tesl ihe carry bit, then 
we must shift Ihe Multiplier by one position eight separate 
shifl 
jv *Tw rk. ^% rjt /-TV ,-Tk ^Tw -A — 



"□ 



STA TMP 
ADDRESS 
STA RES 



AS WELL AS THE RESULT BYTES 



STARES+1 ; AND (HI) 

LDX SB ; WE ARE USING THE X INDEX 

REGISTER A5 A COUNTER 



figl 

times - its right-most bit will 'fall' into the carry bit (flag) 

where we will test it each time in order to take the 

appropriate action. Ne*l ihe Pailial Product (PP! which is 
accumulated with each of the successive additions will 
require the use of sixteen bits, obviousiy miilliplving two 
eight hit numbers could produce a 1 6-blt result (255 x 255 
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= 65025). Unfortunate y the !. >!D has few internal 
registers whii h mem* (h.;i ih-> partial product, (he 
Multiplier, and In '.'ill' i. < -si i-1 ; nnot be stored wilhin 
the 651U itself, rherefore we must set aside some RAM 
memory locatio-s. <i- i-xu rml i ['liters, within which to 
store them (Pari .11 product into Rl> and RES+1, Multiplier 
into MPR, and Mul:i|:li: , :l 1-10 vtPD). Wo will sliil'l tin; 
Multiplicand leu ■ -\ lo . u . ::.l .■-> labelled TMP prior to 
adding it to the Pan ,il prodw I 1KI S. RES+1 ). 
We shall now examine this routine in more detail. There 
are several important points to discuss, as well as the 
instructions which we have not coveted before. It is very 
important, when developing good software, be it games, 
utilities or even demo?, to have a thorough understanding 
of the multiplication issue. 



DETAILED EXAMINATION 

Lines 10 to 40 are quite simple, we have dealt with load 
and store instructions, and so they do pot require further 
explanation, save to say that if this is an often called 
routine from within a larger program, then it is good 
I >rogr, miming practii e i'i /■"< ' I lie temp' naiv dala iivle < irn. I 
the two-byte resull before ■ 



Line 50 LDX #8. This is our first use of the X index 
register and we are going to use it within this routine 
merely as a loop counter. So, by using the ff symbol, the 
same as the LDA instruction, we haw instructed the CPU 
lhal the value following il is the literal value of 8 which we 
store within the X register and nol the contents of memory 
location 8. We are using the counter in ordei to stop 
shifting the MPR al the right lime. We need eight shifts, 
tine rot eai li bit, so c,k ;■■ 1 1 n n_- ,:: shift oeiurs. w: 1 let rerun it 
rhe X index register. As soon as the value of the X regisler 
reaches zero the miiltiplii a.lii m 1 1,1s finished. 



Line 70 LSR MPR. This instruction means 'Logiial Shift 
Righl' the contenls of the byte MPR. We must test the least 
significant liit itli.it is. Hie righl-1110-.i bill of the MPR, and, 
as I indicated earlier this cannot be done with a single 
instruction. So first we must 'shift' it, then we must tent the 
( .iiiv I'll li, : inn ...Hi if the bil sn "ed out was ,-. I or ..1 ii, /mil 
use this to either branch or nol. II ihe bit was a ihen Ihis 
indicates a 'no addition' situation. 

Line 80 BCC NOADD. Test the the value of the carry flag. 
BCC NOADD means 'Branch if Carry (bit) is Clear' to the 
address labelled NOADD. If the carry is clear, then this 
tells us that the bil shifted out of the byte was a zero and so 

il rloes nol require to be added. 

This is our first encounter with ,1 branch instruction. So far 
the routines we have dealt with have all been sequential. 
In olhe; words .■.!. Il i"sln.,i li.in he ■■:■ e.i-i li'i-T iflii ill'.- 
previous one. Obviouslt we nn-d to perform logic.il tests, 
such as leslrng Ihe 1 ,-i'tv mi. whii h will direct us to auuthei 
part of the program, similar to ihe IF.. .THEN of Basic. 
Bunch instruction, pertnim such fiUKlions. In our bi.iiu h 
n BCC the CPU will branch to a new address if 
arry bit = 0, in other words the r 
:ss NOADD (i.e. line 170 - ASL MPD). If the 



in other words the carry was set (=)) then no branch 

won Id net 111 Ihos program execution would continue wilh 

■ after BCC NOADD. 



Line90to150 The lest failed and the carry bit is set. We 
must add the MPD to the Partial product (here the RES 
regislers). 1 he MPD is held in TMP and MPD. The 16 bits 
of the Partial product are held in RES and RES+1. We 
dimply arid together ihe two 16-bit numbers as we did in 
the 16-bit addition of the earlier program (Sixteen-bit 
Addition). 

LDA RES - the Ac is loaded with the lo-byte of RES. 

CLC - prior to any addition the canv nit must be cleared 
ADC MPD - add the MPD to the Ac which already 
contains RES lo-byte 
STA RE5 - store the result of the low pan of the adriilion in 

RES lo-byte uhe i .irry will be either set or cleai depending 
upon the result of ihe addition, and any carry which may 
have lii.cn generated will canv over to the hi-order part of 



there 



jftl. 



LDA RES+1 
ADC TMP 
STA RES+1 

These three instructions complete our 16-bit addition. We 
have now added the MPD to RES, however we must Still 
shift it by one position to the left in anticipation of the next 
add. 

Line 170 ASL MPD - 'Arithmetic Shift Led' will shift the 
contents of the legisler MPD one position to the left, the low 
pail of the Mulliplic and. However we cannot lose the bit 
whir h falls on ihe tell end of die byte. It 'drops' inlo Ihe 
carry but we cannot leave it Ihere because it would quickly 
be desttoyed when we perform our addition. It must, 
thurelorc. he placed ink! a semi permanent location. We 
use TMP for this. 

Line 1 80 ROL TMP - 'Rotate Leff the contents of TMP. This 
k different to SHIH in lhal it performs the same function but 
willi ihe additional leatuic lhal the- bil in Ihe carry is forced 
into the right-most bit position and the bit which 'falls' off 
the end is placed into the carry (see Fig 2. Rotates. The 
ligurc demon si rales the left rotate, KOL, to demonstrate a 
right rotate, or ROR, simply reverse ihe direction of the 
■ irrow-si. So ihe nil which lell off the leii-most end position, 
during eveculion ol ihe previous instruction ASL MPD (line 
l 7(>i, and held in the '.any will now lie Ion ed into the right- 
most position of Ihe register TMP. 

I his finishes with the aiilhmetit operations of the rouline 
but we must slill test whether the operation has been 
performed a full eight times. 



]■ -^ fj* /^ S\>- ^ *V - ^KH" 



-a- 
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Line 200 BNE MULTIPLY - 'Branch if the result (in this 
case, of the X decrement) is Nt.il tqn.il I" '<-<o' to memory 
address MULTIPLY (Line 60). This is another test-and- 
nrain.h instruction. While the \ mde>: :et', ■iter rl<>i semen!-. 
to a non-zero value the CPU will automatically branch 
back to the the memory address following the branch 
instruction, in this program. MULTIPLY. If X h.as 
decremented lo zero then the result of the lesl will be l.ilse 
and so the CPU will execute the next s< 



use the space-bar to 'step' through each line of the 
program. All of (he registers are displayed in binary dibits 
which will give you a much c leaiet picture nt evaitk whal 
Is taking place, especially during the 'shift' and 'rotate' 

It [s not the best of programs, just the 'bare tones' but it 

understanding of ML. After you have used the trace, 

maybe .liter several times, you will (ull\ understand the 
mechanism by which infirm linns manipulate (he contents 
rif memory, of the CPUs registers 'Ac' and 'X', and just 

how the carry bii (flag) 'C, is being used. 

if you wish, create your own trace prograi 



paper and v 









time that a routin 


B is written it i 


The flag used for this te 


st is the Z fla 


g (See Status Register - 


by hand to ascen 


in (hat its resu 
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Line 210 RTS - remrr 
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eij-hl zero 

would pla. 

MPD. The C 



t and (he TMP, RES, and RES+l registers 



THE TRACE PROGRAM 



nlly in 



It is very important, if you wish lo pro; 
ML, thai you idly under-land such a typical prograi 
the 16-bit multiply routine in complete detail. I have 
introdui I'd you lo main new insliuctions. and the routine 
is much longer than any pretiuuv I slroni;!v Mij;j;rsii'd. 
before you conlinuc, lhal you load ihe progiam railed 
TRACE, which can be found on (his months disk. It is a 
BASIC program which simulates the ML routine and will 
step, or trace, through each Instruction of (he multiply 
routine displaying each of The lejiisicrs used and ui.iuaiinjj 
. them during each iteration. It is simple lo use, jusl input, 
when requested. Ihe multiplicand and the multiplier, then 



n STA TMP will change the dashes in 
■n with each instruction, I've started 
-alions lor you but it is up to you to 



■ undetermined, si 
The nex 

TMP to zeros, and so 
the first of Ihe eight it 

finish it. 

Using the hand trace method in conjurH tion with the 
BASK" l-ate piojiram will allow you lo verify that which 
you do by hand. All of this Will, essetitially, leach you very 
jim id prijiirariimino, practice and lei hnitjue and will ensure 
that when you start wriling your own programs you will 
create more fluent pro-ams. with lewer 'bugs' or logic 

BACK TO MULTIPLYING 
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ti ran be written, 



add in 



3 the 



rand ii 



multiplicand to Ihe left before adding. What „, v , 
advantages of such modification? Well we would not 

have needed [he tump, irorv roister, TMP ■ ,1 sating of one 
memory location! This is not such .1 drawbu. k. unless we 
ate really pushed for memory. However, il mighi make 
the program run somewhat faster, and this ran be very 
important. 

Diet live programming requires us lo spend lime looking at 
detail so that we can reduce I he length of a program, and 
improve iis execution speed. Using shifts lor the result 
and the multiplier (onsumu insfruclions and lime. The 
'trick' which we can use in multiply algorithms is that 
even,' time the multiplier i. shifted to (he right ihen a bit 
position cm the left is freed up. We can also see that the 
first result will Like up., at the most, nine hits unci thai .irlt-r 
the next shift ihe resull will be increased bv one nil again 
What ihis boils down to is that we can reserve one 
memory location for Ihe resull lor partial product) and 
Ihen use the bit positions which are being freed up by Ihe 
multiplier as il is shifted. Now we are going to shift the 
MPR (multiplier) right whit h will tree a bit position to the 
left. We will enter the left-most bit of result into this 
position (hat has become free. We will use Ihe X register 
as our counter for the number of bits beine, shhWil 
Unfortunately ihe CPU only has one inlernal regislei 
which can be shifted, and lhat is the Accumulator 
Because we are going to shift both the result and the 
inuliiphoi we need 10 determine which one we should pul 
into ihe Ac. Well, since the resull musl be added lo ihe 
MPD every lime a set bit is shifted out, and sinee the CPU 
also adds somelhing only lo the Ac, then the result is bes! 
served using the Ac. The other numbers will reside In 
memory locations. 

A,- (result high-byiej and RES (resull low-byte), MPR and 
MPD will be as before. So, then, here is our alternative 8 
x 8 bit multiplier: 



10 


MULT LDA#0 


20 


STA RES 


30 


LDX#8 


40 


LOOP LSRMPR 


50 


BCC NOADD 


60 


CLC 


70 


ADC MPD 


so 


NOADD RORA 


90 


ROR RES 


KM 


DEX 


no 


BNE LOOP 


120 


RTS 


130 


RES BYT 


140 


MPR BYT 5 


150 


MPD BYT 3 


160 


END 


Line10and20. LDA#0 


STA RES 


here w 


e are using the Ac for the high byte 



I ine Hi BCC NOADD the resull of the shift has two 

po-s h Inn.-, either the carry is set or clear. If clear, then 
no .Midiimn is required so branch., olherwise continue with 
Ihe next instruction which is to perform ihe addition. 



We must always clear Ihe carry before addition land we 
know it must have been set simply to have reached ihis 
stage of the program). So we add the multiplicand lo the 
accumulator (Ihe Ac holds ihe high-byte of the result). 



ihis is the Partial Product held in Ac and RES. By shifting 
"■.'lul ; ::.n.. Hie Ae righl one bit, Ihe left-most bit will drop 
'-ti "Ho the cany. The carry bit is then Totaled into the 

Hi:- iresiih low: register which lipids the low-byte oi (he 
result 



Line120 RT5 return from subroutine to caller. 

I me 1 30 to I 50 are the memory registers we are using for 

if you examine this modified toutine you will see that it 
uses around half the number of instructions, and, as a 
resull oi this, and Ihe selection of the correct registers it 
will execute a lot faster. 

A straightforward program design will work, but with a 
hltle thought we can make it work more efficiently. 

IN CONCLUSION 



Well, 
but ne 



covered a lot of tricky ground this monlh, 
:ss il is ground lhat needed to be covered. 

iddil.ion and subtraction programs, and 
create your own. See just how you might improve on 
Unrigs. I recommend thai you use the trace program until 
von lully understand Ihe first H . l.i bit multiply program, 
Ihen move on lo the second program and compare Ihe 
two. Note the changes and jusl how ihey can improve 
etliciency. You can create your own trace program on 
paper, as ! outlined curlier, tins will clearly show you how 
things ,'iii- the regi-lersuiui Ihe shilis work. 
Unlrl Next Month 



and RES for the low byte of the result. So w 



ON THE DISK 



WORDSEARCH 



Create your very own customised WORDSEARCH puzzles with ease . by STEVEN BURGESS 



Are you mad .llxnii tiiOM- wnrdsearili puzzles? Wouldn't 
you just love to make your own customised 
worclse.ircht's- In baffle your friends and colleagues land, 
if you lose the grid showing all the answers, even 



Prints the Wordsearch grid out to the printer. The grid i: 
30x30 and uses thirty printer lines. Between each lette 
across there is one space. 






elf.) 



Well, my deat friend, read on and all your dreams will 
ilised. All your hopes fulfiled and all your friends 
rid colleague- will h.ite your j>uts. 
When the program has loaded via the C.D.U. menu, 
'" be presented with another menu. The options 



be 






■, i, ■■!,,. ■ 



CREATE WORDSEARCH 



LOAD WORD LIST 

Allows you to load a previously created wo 

END 

Thin simply returns you to the C64 startup sc 
pressed il hy mi.st.ike ihen switch on the drivi 
C.D.U disk and type: SYS 21 52 




ENTER WORD LIST 

This option allows you to enter the word list. You can 
choose how many words you want lo enter bul I 
wouldn't go loo high. Once you have typed in a word 
there is no going hack, except lo start .mesh, so make 
sure you type very carefully indeed. 



HOW IT 
WORKS 



perfectly random 
basis. First the 
computer decides 
which way the word 
will run, and there are 
eight different ways. 
Then it will decide 
upon ihe x and y 
coordinates in the grid 
where the will starl. II 
checks first if the 
word will fit and, if it 
will, if there are any 
other letters in its path. If there aren't then it places the 
word. If there are, and the word can still he placed 
because it can safely emus through the other word then 
Ihe word is plai cd. If neither ol these two are true then 
ihe computer chooses another direction, another x and 
anolher y coordinate. This data can be seen flashing up 
when you select CREATE WORDSEARCH. 



on [host 



SAVE WORD LIST 

Allows you to save your won 

filename and then saves as a se 

PRINT OUT WORDSEARCH 



FOOTNOTE: (his program was. written with the aid of 
o diskette. Asks for LASER BASIC, from the OCEAN IQ range of utilities. It 
al file. was compiled wilh LAS EH COMPILER. 

For owners of LASER BASIC, there is, on the disk, a 

copy of the source program whicli you can mess about 



LETTERS 




solve my problem Dad? No! 
Bui I know a man that can... 
"JASON FINCH" circa 



When I closed last month 1 told you thai I would bring 
you news of a program lhat gave R.I.I DISK IAC.KI- 1 it's 
compatibility with the STAR LCIOC. Well, here it Is. A 
couple of people, namely MR CLIFF KENDALL OF 
CUMBRIA and MR DENIS REDINCTON OF ESSEX, very 
kindly sen: me copies of the program that they had 
modiiied for use with the above printer. I had to choose 
one and, because they were both of a high quality, I had 
toga on a first come first served sort of ba-is which meant 
that MR.KENOALL was the lucky man. On the disk this 
month you will find his program, filed as "STAR FD|". I 
hope that everyone will appreciate his work. This month I 
have selected ten letters from the mailbag for you to 
peruse at your leisure, three of which arc from outside the 
UK which makes me very happy. To everyone lhat has 
sent letters and hasn't vet received a lonnai reply, please 
hear with me. Due to the volume 01 letters ih.it we receive 
at the TECHNO INFO HQ it just isn't possible to answer 
them all personally. The great majority of you will receive 
replies as soon as it is possible and a lew of you w ill lie 
privileged enough to receive a telephone call 'from yours 
truly if you supply your number!! Anyway, if you don't 
receive a reply straight away, please do not send me 
copies of your letter asking what has happened. This only 
confuses both mysell and my filing system! From this day 
on I am guaranteeing that everyone will have a reply 
either by post or in the magazine eventually, and as 
always, any disks sent to me will he relumed. Plea.e have 
patience. Well, now lhat lhat is over, let's gel on with this 
month's selection ot letters. I hope that you find Ihem to 
be both interesting and useful. 



In the years BC (Before CDU) I used to buy the 
Commodore games 'comics' for the software and 
hardware advert-. VVli.nl I would like to see, therefore, in 
CDU is perhaps more adverts: Especially from companies 
such as Datel Electronics, etc. Secondly, size - not so 
much a criticism, rather a point of view. I would like to 
see more leatures in the magazine and for this I would be 
willing to pay extra and still consider il good value for 
money. What ihis really points to is that the magazine is 
gre.il. keep up Ihe good work! 
David Brown, Newport. 

Dear David, 

[hank- very much for all your kind remarks about CDU 

and "lechno-lnio" in particular. II really is great to receive 
letters like yours because it tells me thai I have got the 
lormula for this section correi 1 and I'll do my best lo keep 
it up. Regarding [he advertising in the magazine: It just 
isn't possible to Iwisl Ihe arm- of companies into 
advertising with us. tverylhiiig in our powei is done to get 
the advertisement balance right. I have no objections to 
ihe magazine being thicker - hut it's not as simple as 
"Right, I think we'll make it twelve pages extra this 
month". Those sort of decisions have lo be taken by 
echelons thai lie above my head I'm afraid. I'm all for a 
thicker CDU - then we could have an even longer 
technical helpline and I'd vote for that any day. More 
money, you see. Anyway, thanks once again for your 
comments. I hope that you continue to find CDU 
informative and helpful. 



THANKS FOR CDU 

Dear CDU, 

I doubt that I will be the first this year to praise your 

magazine for its content, but I feel that I should make m\ 
reelings known. I have only recently found out ahou'l 
CDU and was, lo say the leas!, pleased thai some. me had 
the sense to bring out a magazine for those who realise 
that computers are for more than just vegetating their 
brain on games. Especially do I find Tech no- Info* 
interesting as it helps ever/one to get more from their 
machine - even us lowly ones that know very little 
machine code. However, if I was lo be critical, I would 
say that it lacked only two Ihings. Firsllv, advertisement. 



OCPANDTHE120D 

Dear CDU, 

Help! Could you please send me information on how to 
configure a Cilizen I2GD printer for use with the OCP 
Advanced Art Studio. I hanking you in anticipation. 
Norman Merrill, Cambridge. 

Dear Norman, 

Certainly I can. Here are the answers lhat you should 
enter lo Ihe question- as ihev ctop op: s. 4. 8, i. 17 65 B, 
480, 11 75 48!). %0, 17 76 %0, 0, 13, 0. That should 
lake you lo Ihe summary screen. If not then check* 
everything again. Fntries like "17 65 3" should be entered 
exactly as shown In the on-screen examples. Thai should 
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DIVISION SUMS 

Dear CDU, 

I need a bit of advice (and a devil of a lot of instruct^ 
The attached algorithm lor calculating the date of Ea 
Sunday was taken from the "Scientific Americ 
magazine many years ago. When I came across it the o 
day I decided to try to convert il into a C128 program 
found i! beyond my < ap.ib: lilies. And so I come to yoi 
few of the steps ask (or the remainder of a division sun 
be isolated and others say the same thing about 
quotient. Can this be done on this toy machine of mi 
All the besl and my thanks for a good, readable magai 
even if you r.an'l help me on this occasion I 
Eric Frost West 5usse*. 



Dear Eric, 

First of all, why do you say that the CI 28 is a "toy" 
machine' The CI 2K ran be turned, through a few pieces of 
relatively inexpensive hardware, into a very powerful 
machine. Secondly and more importantly, I can help you. Ii 

lent b) using 

h. ile numbet 

164 29=5.655 (5, 

les the number before 

be found quite easily. 
complicated 



snails very happs. A suitable piece of software is marketed 
by GASTROPOD iCels All Snails Tabulated Releasing 
Overwhelming Piles Of Data). I confess I am just a little 
surprised that PAULETTE YVES, whose name bears a 
striking resemblance to that of our revered Editor, did nol 
approach him with the business problems ..is he has shown 
inilialive and competence in keeping CDU magazine alive 
with ;he minimum of annoyance to readers. 
NEDWOB (whose name bears a striking resemblance to 
A.H.Bowden), Bishop's Stortford. 

Dear Mr.Bowden, 

i must thank you for writing in with thai help for Paulelle. I 

presume that your last remark is a favourable one for Sir 

Eves but I must admit that I had not spoiled the similarity 
between Paillette's name and that of our greal Editor. The 
world is full of coincidences, isn't it! I'd like also to lhank 
you for the interesting expenditure pie charts that you 
included with your original letter which we unfortunately 
can'l print here. Thanks once again for your 
correspondence, such a great reply lo the spoof letter. 



you are perfc 

variable 'D'l then you can lalcu 

ib- formula <.HNT[N/Di. This ml 

part of the answer. Tor I «am 
remainder 1 9). The INT function i 

the decimal point so the quotient 

The formula for the remainder is 

but can be found with a little mathematical trickery- K-- 

HN/D)- INT1N/D!) -D, To use the previous example again; 

El/D'=5.655, 'INT(N/D)'='-> and therefore the expression in 
e brackets is equal to 5.655 minus 5 which is 0.655. By 
ulliplying this by the original number that you were 
rlividaig by. you will gel <}.<>:> 'i limes 2'j which you should 
lind is near enough I'X which is indeed r he remainder. You 
therefore have those two equations for i alrulating the 
quotient, Q, and the remainder, R. Hopefully that will have 
been of some assistance. 



SNAIL TRAIL 

Dear CDU, 

If I may be permitted I am sure I can solve at least some of 

the problems posed by your correspondenl PAULETTE 

YVES :Volume4, Number 4, Feb 1991). Firstly she should 
tell her advertising manager Ihat hi. salary can stay at five 
figures but in future these will be 112.5.4.5 per month. The 
employee who took an unscheduled holiday in Germany 
should be told, "We congratulate you on your personal 
initiative and we don'l know how we could manage 
without you but from Monday we are going to try!" Auf 
Wiedersehen, Pet (or CM)! Also try allowing your stud 
snails lo feed off your neighbour's lettuces you can cut 
feeding eosls drastically. Software In control Ihe whole 
operation must be in machine code. This will increase Ihe 
speed of various snail activities, especially breeding 
propensity, and will stimulate pioduction and make a lol of 



TAPE TO DISK 

Dear CDU, 

I'm a C64 owner and ever since I saw your mag I've been 
oneoi your many fans. Well, I think I should get straight to 
Ihe point so: 1 ) I've recent l> bought a 1 541 II disk drive and 
I am transferring all my games from cassette to disk. 
However, I'm facing problems with the multistage or 
mulliloarl 'or whatever they're called! games - ihe ones that 
when you finish one level, then loads ihe next one. Could 
you give any help? 2) Where can I find a book telling me 
what ihe rn.u hine language enmnnnris are equivalent lo in 
BASIC. Could you publish il? Quite difficult, right? 'ii Is 
there a possibility ol transforming Ihe II S program for the 
CI. IB into one lor the CM il own the AC I ION REPLAY 
MkVI - will the SLIST command help?). Thanking you in 
advance. Keep up with the good work and try to put in 

|ohn Kopsidas, Greece. 

Dear John, 

The secret for converting tape multiload games to dfsk lies 
in the conversion of lape load routines to disk load 
routines. This is ol course a drag to do and so is best left to 
a backup cartridge. You say you have AR6 but that doesn't 
rr.illv help bciause u doesn't cater tor multiload things. 
Trilngn ', f XPERT Cartridge will lie able to help you. It isn't 
u-.illc possible lo relate machine code commands to BASIC 
ones because machine code is so sort of "raw" and down 
to the bare minimum. One machine code command may 
require several BASIC ones (and vice versa), However, a 
number of them can be directly transposed and hopefully il" 
the King of all Editors, Paul Eves, has done his job, you 
should find a lable elsewhere in the Techno-lnfo section 
illustrating some of the more common relationships. 
Regard inn ILS. it is mn possible to convert the program for 
use on Ihe CM direi tly. Another version would need to be 
written, The SLIST command idea might work but it would 
be very tedious and take an eternity, and besides, Ihe BASIC 
program is very long and you may get an OUT OF 
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MEMl >KV error with ilk- large ihirnbei i il variables used by 
ihe program. Also, some commands of the CI 28 are not 
implemented on the C64. Il would be best to wail and see 
whether the author writes a CM version. 



GEOS COMPATIBILITY 

DearCDU, 

I hope thai you can be of some help lo me. I have a t,4C 
and disk drive and a BROTHER HR-S primer. The problem 
is when I load my GEOS disk ami I sel everydiing up lo slart 
to wrile, when I gel to prim what I have lyped in my printer 
does not work. I have set the printer up as Commodore 
Compatible. Is this lhal my printer is not compatible with 
GEOS! I have tried setting my printer wilh various DIP 
switches bul to no Good, Have I bought a pig in a poke or 
can you set me in the right rlirei lion; Abo I wonder if you 
can fell me where I can obtain the following books. I have 
asked the publisher bol ihey don't sell lhem now. Any help 
would be appreciated as I ret kon that with all the tiJCs thai 
are still being sold, oilier users, would like lo gel some 
books lo help them. The books are: The Complete 
Commodore !>4 ROM Lb-assembly by P.Gerrard and 
K.Hergin: Impossible Routines for ;he Commodore '■■! by 
K.Bergin; Further Adventures f.4. Will you slill love me 
when I'm 64f, Advanced BASIC and M/C for the 64, Sprites 
and Sound on the 64, all by f'.Gerrard; ,-inri Sound Effect 
and Music on the M In- VV.Tlii iil : -i and A. Vcl!,*. I lop ni; that 
you can be of help. 
H.Lane, Clwyd. 

Dear Mr. Lane, 

Unless your prinler is Ihe Commodore version of the 

printer, ie the HR- .">(". you will uol get any results using the 
Gi mm .Com pat prinler driver, [his is for printers connected 
on Ihe serial bus which I presume yours isn't although you 
didn't say. You will need lo purchase an interface for ihe 
computer and use a ililrerenl pi intra driver it yon yvanl all to 
work perfer lly. The prinler should work with ihe computer 
with a suitable interlace. For more information on the 
necessary interface I would recominen 
a company called Meedmore in Merseyside on 051-521- 
2202. They are usually very helpful and know what they 
are going on aboul. With relation lo Ihe correct prinler 
driver, I would ring Tim Harris at FSSL on 0386-5S3153. 
He'll be able lo take you iurlher on lhal side Of the 
operation. Regarding the books, the only place i can think 
of is a good lown library. If Ihey are no longer sold by Ihe 
■■■• I lien il is unlikely thai they will ■.till be available 
in shops. An alternative, however, lo one I can recommend. 
It is "The Analomy of tire Commodore f>4", sold by FSSL, 
which has a com pi e;e ROM disassembly of the 64, 



1571 disk drive, MPS-801 printer and a colour 

monitor. I hi- is Ihe very firsl computer I have ever owned. 
This system was chosen above the IBM range. - the reason 
being bei aus.- il i\ so user friendly and I fell it was ihe ideal 



computer for the whole family to use. I now buy your 
magazine each month. There are a couple of problems at 
the moment lhat have me confused. Some of your 

programs load in the 80 column mode. What does this 
mean exaclly? The other problem is thai on some of them 
they have a less ih.in sign after ihe file type in tin- dn\ lory. 
You say lhal if one uses a disk edilor to remove this 
protection one can tlren load tin- f t . ■ ,: ■ i ■ I ' ■ ■ ■ m'd 
y hi ! \pla in how one :;oi~. alii ni rii iin... I his a no .'■.'• ■.-. iwe 
would I get a disk editor. Abo, how does one move the file 
entry io Ihe top of the directory? Could you possibly also 
give me some information on whom I may coniact in the 

':■■ -i il li | .. ■ I-,- ■:■■ ■., .|la .||. I ■ ■. mail I I, ,pr:; \ , , L I r all 

be of assistance lo me and also, keep up ihe gocid work in 
your magazine. 
H.G.Carroll, South Africa. 

Dear Mr.Carroll, 

The CI2B has a built-in eighty lolumn mode which is only 
available if you have the necessary monitor or a composite 
moniior with a certain special lead. Programs for eighty 
column mode will not prodin e any effe< i mi ihe screen of 
a standard moniior for ihe iorty column mode. These 
programs have been socially designed yvilh an 30 column 
...■■in mi nri. Til 1 : removal of the less than signs is 
complii aled lo explain in leM so I have provided a program 
on the disk, filed as PROB, that will do it lor you. Just load 
and RUN the program, follow all on-screen prompts and 
then sit-back whilst the protection is removed, after the 
program has located the file in ihe directory of course. To 
help il do this you are asked il you know whal sector oi ihe 
directory track the entry can be found in. II is nor possible 
lo know this without a disk editoi re. illy so just press 'N' for 
no and the program will do ils stuff. I can only recommend 
thai you possible invest in a back issue if you can and look 
back lo my arli< Ie "Directories Explained" in ihe February 
1990 issue if you really yvanl to knoyv detailed Ihings aboul 
directory manipulation. That article should provide you 
with all Ihe information you need for rearranging your 
cliiectories - untorumately it is ten i complh aled lo go into 
here bul I hope I have been of Mime help already. There are 
many companies in Ihe I. Ik lhal sell software and hardware 
by mail. There hallows just thiee Tn h necessarily mail order 
companies but ihey do mail things if you get what I mean!] 
that come to mind straight away: DATEL Electronics Lid., 
Fenton Industrial Estate, Govan Road, Fenton, Stoke-on- 
Trent, England; Evesham Micros, High Street, Evesham, 
England; 'end now a company mat is definitely m3il order) 
FSSL, Masons Ryde, Deflord Road, Pershore, 
Worcestershire, WRKJ IA/. England, li you are looking 
panic u I a rly I'oi games software ihen perhaps you should 
join the Home Computer Club. I've only got an Amiga 
version of their advert, bul the address on that is The Home 
Computer Club, Swindon, SN 3 4BR, England. 

CHEATS NEVER PROSPER 



a it" mat hine code for ^i 
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use 6510+ Assembler. Trilogii Expert Cartridge, and 
Codemaster - all indispensable in my quest for 
cnlighlenment. (.!)(.■' is also indispensable and is probably 
as near perfeclion as possrl )k'. Of course CDU should be 
publisher! weekly and [he low price is loo low. My only 
interest in juntos is what l hey can teach me about coding. 1 
have a BASK, loader for n cheat tor Spiudi//y II dries not 
appear to work. GOOD! I ilon'l want to cheat or even play 
S|jirn!i//y. I am more inteiested in what it does, how it dues 
it, and win- it doesn't. The In.idci si, lr ts as lollows: 10 REM I 
LIED, 20 F=679 and then it goes on to read in a load of 
DATA and store it al thai 679 onwards. Conerring il all to 
machine code I get: SEI, LDA #$.H STA $01 , LDX #$06, 
LDA S070fi,X, STA $O0DF,X, DEX, BPL somewhere, LDA 
#$37, STA SOI, CLI, RT5. Now lor the questions. This 
routine is supposed to be loaded beginning at address 679. 
Mi mili-iini; reset memory I get: 02A5 00 BRK, 02A6 01 00 
ORA ($00,X), 02A8 00 BRK. I guess that 02A6 01 00 ORA 
(S0O,X) is there for the benefit of the C64 or perhaps is a 
product of the cartridge used to reset memory. Question: 
What is 02A6 01 00 ORA (S0O.X) lor;' Loading the short 
machine code routine to the specified address causes 
problems for address (VJA6 because the next address is 
02A8 - il is supposed to load at 02A7 which is obviously 
wrong because the instruction at t>2A6 takes two bytes. So 
should I move it to 02A8 and SVS it al 680 decimal? The 
machine code routine sets the interrupt flag, alters the 
memory layout, copies some locations across then resets 
the memory map to default. More questions: I think it is a 
spoof. Hence the REM statement 'I LIED' in the loader 
because it just appears to copy blank memory to blank 
memory. Am I wrong? If so, what does it do? The only 
thing I can say is thai bit 2 of location 1 is zero. Apologies 
for the garbled nature of this letter. I normally use 
CeoWrite but my printer's not well. Thanks for any help. 
|im Wyatl, Derby. 



Dear Jim, 

Glad you think thai CDU is near perfection. Sorry il can't 
be published weekly though I To answer your questions, 
you have firstly misinterpreted the machine code I'm 
afraid. You have not taken into account the lo-hi byte 
storage system, the commands Hi. it you identify as LDA 
$0708, X and STA S0ODF.X are in fact LDA Sl')8(i7 \ and 
STA $DF00,X. This then perhaps makes more sense 
because the codes for the "I I It \r statement will lie poked 
into memory high up. 5pindizzy would I presume check 
this location high up in memory to see whether the levi 
was there. If so, cheat mode enabled! I don't think that it is 
a spoof. If it does not in fact work then remove the space 
before (he REM and the "I", That may then help the 
proceedings. The reason why you gel spurious results 
upon reselling and reading memory is thai (he area in 
question is filled wilh null and important bytes when the 
machine is reset. Nothing can be stored then- permanently 
so to speak, like il can at places elsewhere in memory. By 
permanently I mean the code will still be there alter a 
reset, not after switching off and then on again. The code 
that you disassembled means absolutely nothing ami is jusl 
the null byte information. To summarise (hen, the program 
is probably all right and seems lo do something and it is 
just that (hat section of memory is resel itsell upon resetting 



110 VOLT PRINTER PROB 

Dear CDU, 

My problem is with a STAR NEX1000 printer that was 
purchased in the USA along with a CD Grappler. This 
system worked perfectly on my brother's Commodore 64 
system IN the USA, but when hooked up similarly (with 
ihe .impropriate Mil vol: [.'ower simply) and using the same 
PRINTSHOP package, as again used in the USA, printing 
occurred but in a haphazard manner. I have enclosed ,i 
copy of a letter beading using tins system lor your perusal 
and any comment you would care lo make to rectify this 
problem would be appreciated. I do recall, but as this time 
cannot find, a problem being stated with a STAR printer in 
a previous issue of CDU where it was stated, as I 
remember, that the 'internal clock' was causing (he fault. 
Could this lief If so, what is the remedy as it seems to me 
that all talk of compatibility with Commodore 64s by STAR 
is hui.'.w.ish. No: thai it isn't a uood printer, it's superb, but 
my MPS-H01 is far more compatible, I will close with a 
heartfelt (hanks to all your staff. Pick at this letter as you 

A.l-lllai knell, Norlhanls. 

DearMr.Blackwell, 

First of all I must thank you for sending in a sample of what 

was going on '.villi your printer. It certainly would seem 
thai it is (he internal clock that is playing up because each 
time you produced the letter head, it was doing the same 
i ■ ■•■.I"- ■ poinrs lo .i i.u.'i lliai is not ju-t random. Il is 
due lo the USA supply being si My hertz frequency and not 
50Hz like it is in (he UK. The voltage is only one part of 
the pioblem. Tire printer will be expecting a frequency 
higher than (hal given lo il which will, in simple terms, 
confuse il. I think thai Tandy shops sell converters although 
most large, good electrical companies will be able to (ell 
you the best Ihing to buy. You need a supply frequency of 
:>0H/. Failing thai I can't see why Ihe printer Is playing up. 
Regarding STAR < ompatibility - I can say with total 
confidence that talk of compatibility with Commodore is 
NOTbogwash. I have a STAR LCI printer myself and am 
most satisfied wilh il. Il works wilh every priming program 
(hilt I have and as of yet I have come across no problems 
with it. Wilh a bit of luck I will have been of some 



DISK FORMATTED? 

Dear CDU, 

First of all. from February - happy birthday to Techno-lnfo, 
and long live CDU! Here is my problem: in a BASIC 
prugnim of my own IC64 and 15411, I need to write a data 
file lo diss. Past experience told me lo lie shghlly cautious, 
so i told lb.- progr.in: to portoim some Ie4s before writing 
the file. I'm able 10 test the following wilhin (he program: If 
Ihe drive is on, if there is ,i disk in the drive, if the file already 
exists and needs lo I x-i scratched. But I'm not able lo test if Ihe 
disk in the drive is already kin n.i't ted. Could you help? 
Roland Dept, Belgium, 
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formatted that is also easy to understand is by attempting to 
load the directory. It you Ret a redd error then it is probable 
Ihat the disk hasn't got a directory and is therefore not 
formatted. Other i ircurnsianccs could bring alioul the same 
resulis but I should think that this method will suffice. Execute 
the line: OPEN 15,8,15: OPEN 2,8,0,"$": INPUT#15,E: 
CLOSE 2: CLOSE 15. If it ends up thai the variable E is not 
zero - check whether il is the error value for one of the read 
errors that can be found in your drive's manual - then an error 
has occurred and you may assume that the disk fs Worth 
formatting because il can't find a directory, 

UPDATE 

Now 10 this mcinlh's fechmi-lnio l.l|>ri,ili-. ["here is just one 
thing to report back on. MR SIMON COLLINS OF NORTH 
HUMBERSIDE has informed us of the POKEs that MR 
SANDERSON OF SOUTH AFRICA was after in the 
December 1») issue. I hey relate to the game 'CAME OVER' 
and provide infinite lives lor it. You slmuid load up ihe game, 
reset Ihe computer, and then enter: POKE I 5.344,2 14: POKE 
15245,234: SYS2304. Thanks very much for that little bit of 
help, Simon. 



Finally, il" your program pauses for a while now and then fur 
no apparent reason, il is because all unwanted variables are 
being disposed of. To rectify it, execute the command 
G=FRE(0) „r similar (by that I mean the variable 'G can be 
changed) at regular intervals. If your program has a menu, 
give Ihe uimmand just before the menu is displayed. In that 
way yoj will get a number of very short pauses instead of 
one or two very long ones. 

I hope that a lot of you will find those quick lips useful. 
Remember (hat if you du have any lips (hen send them to me 
at the normal Techno-lnfo address for publication. What's 
more, if you have any hardware or programming problems, 
no matter how complex they may seem, please do not 
hesitate to write to us and we'll do our best to sort them out 
for you. The address is, as always: CDU TECHNO-INFO, 11 
COOK CLOSE, BROWNSOVER, RUC.BV, WARWICKSHIRE, 
CV21 1NG. See you all next time when il will be June, the 
month of my birthday - so I expect lots of cards to arrive by 
Ihe first!! See yer then. 



TIP OF THE MONTH 

This month you are going to have to pul up wilh a tip from 
me I'm afraid. Please keep those tips rolling in and I shall 
publish any that will be of general interest to Ihe readers. But 
for now, I'm going to give a few hints out to users of BASIC. 
In all the reference books that I've read there is always 
something to the effect "The programmer shoold ensure thai 
Inops are complete before he breaks out of them" but it 
never tells you how to go about that. Following are jusl a lew 
little simple hints lor BASIC programmers. Imagine you have 
the following program: 

10FORT=lTO10 

20 IF AS(T)="END" THEN 50 
30 NEXT 

40 PRINT "NOT FOUND": STOP 
SO ...rest of program 

This would exit with the BASIC slack confused. II is the same 
as performing a COSUB and then not RETURNing from it 
properly (Try RUNning the following: 10 COSUB to - the 
computer gets confused because you never have a RETURN 
Command executed correctly). Always ensure thai for every 
COSUB there is a RETURN. Errors occur if there is a 
RETURN without a COSUB but not the other way around. 
Be careful. Bui back to the loops, just use a flag: 

10F=0:FORT=1 TO10 

20 IF A$(T)="END" THEN F=1:T=10 

30 NEXT: IF F=1 THEN 50 

40 PRINT "NOT FOUND": STOP 
50 ...rest of program 



ADC #xx; A=A+xx+C: IF A>255 THEN A=A-256: C=1 

ADC xxxx; A=A+PEEK(xxxx)+C: IF...THEN as above 

AND #xx; A=(A AND xx) 

ASLA; effectively A=A*2 

ASL xxxx; effectively POKE xxxx, PEEK(xxxx)'2 

BCC xxxx and BCS xxxx; IF 00 THEN xxxx and IF 

C=1... 

CLC and SEC; C=0 and C=1 

CMP #xxf/bBEQ xxxx; IF A=xx THEN xxxx 

CMP xxxx f/b BNE yyyy; IF PEEKIxxxxloA THEN 

yyyy 

CPX #xx f/b BEQ xxxx; IF X=xx THEN xxxx 

DEC xxxx; POKE xxxx, PEEK(xxxxl-1 : to 25.5 if =0 

INC xxxx; POKE xxxx, PEEWxxxxi+l : to if =255 

INX and INV; X=X+1 and Y=Y+1: check as for ADC 

#xx 

|MP xxxx; GOTO xxxx 

|SR xxxx; GOSUB xxxx 

LDAflxx; A=xx 

LDA xxxx; A=PEEK(xxxx) 

LDA xxxx,X; A=PEEK(xxxx+X) 

LDA(xx),V; A=PEEK«PEEK(xx)+PEEK(\x+1)*256)+Y) 

LDX/LDY as appropriate for LDA 

LSR as for ASL but divide not multiply 

NOP very short pause 

ORA#xx; A=(AORxx) 

OfiA xxxx,Y; A=(A OR PEEK(xxxx+Y)) 

RTS; RETURN 

SBCffxx; A=A-xx 

STA xxxx; POKE xxxx.A 

STA ww Y - POKE xxxx+Y A 

STA (xx|,V POKE (PEEK<xx)+PEEK(xx+l)*256)+Y,A 

STX/STY as appropriate for STA 

TAX and TXA; X=A and A=X 

TAY and TYA as for TAX/TXA 
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NUMBERS AND BYTES 



Another excursion into the arithmetics of our computers by |OHN SIMPSON 



The third In a series of snglc pan disc j.sions dealing 
with most aspects of programming (.umputers. This 
discussion deals with ih ■ nan Coded 

Decimal (BCD) 

The first principle of repr-^-n: ig BCD s to encode each 
decimal digit separately. To do this will require the use 

of four binary oils, or a half byte (commonly — * ' 

as a nyble). As you may remember from 

discussion, a nyble can hold the decimal repi 
of through lo 15, but as we now only require 
through to 9 (or decimal, the represental 

through to 15 can be disregarded, see table I. 



BITS DEC BITS DEC 
0000 1000 B 

1001 9 

1(110 unused 

1 

1 

'\ if unused 

1 

11" unused 



0001 
0011 

0101 
0(00 
0101 

0110 



TABLE 1 

By using a full uyte s.:*e we can, in BCD, represent the 

numbers from CI Ibrough lo 49. lhat is "1001 1001". For 
larger numbers we simply add more nybles to meet with 
the required size of the number. For example, lei us use 
the number 49,382. In ihis example we will require the 
use of 5 nybles, or 3 bytes (the final nyble being left 
unused), to represent our 5 digit decimal number. 

Byte 2 Byte I Byte 

000001001001 0011 1000 0010 

When we wish to operate (he computer in BCD mode, 
we must inform Ihe processor of our intention. This is 
i-asily done by setting Ihe decimal flag lo Irue (!}, which 
is bit No 3, in the Status Register. There is an Assembler 
coded instruction tor this purpose, namely "5ED" ISEt 
Decimal model. I he eften or this will ensure that during 
arithmetic operations on bytes, an "internal" carry, or 
borrow, will he; generated so that each nyble will not 
represent numbers beyond 9. 

For example, if a byte contained the BCD value ol say 
!7 [0010 0111) and we were (o add 6 (o this number, 
(hen as soon as the Lo nyble reached 9 a carry to (he Hi 
nyble would be gerieialt-ii makm" ihe byte value 3 i 

is 97 and we added the 



6, then when Ihe carry from the Lo nyble is added lo ihe 

Hi nyble, this would cause a further cany lo Ihe eighth 
bit, tir. erlecdvely selling ihe carry flag. (0000 0011 - 
C=l). Ai ihis point we would need to take account of the 
carry flag, and if we wanted numbers greater than 99 we 
would need to incorporate another nyble and add the 
carry to this, and so on (0001 0000 001 1 - 1 03). 

As you can see, by using multiple bytes we can easily 
create numbers as large as will be reasonably needed. 

This leads us on to signed BCD numbers. Deciding upon 
the size of Ihe numbers we require we can "pul aside" a 
section of bytes to handle the maximum size, and by 
adding di\ extra nyble for Use as either the positive or 
■ iatFvi i - Mi oi Ihe number. To indicate how many digits 
are being used it is also possible to incorporate an extra 
nyble, or byte (depending on quantity), to specify ihis. 
Hereisan example ol a multibyle liCD signed integer: 

3 7 4 5 (3 Bytes) 
number 

"745" 
Sign of 
number 

0000 = positive 

0001 = negative 

Quantity of 
digits in 

the number 



Fractional numbers can also he represented using BCD. 

For example Ihe number +7.45. may be represented by: 



numbet of — 
digits + 

decimal point 
is on the k-u 
of second digit 
ne greal advantage of BCD is lhal it will yield absolulely 
irrect results. However it does have disadvantages in 
at it will use large amounts ol memory which result in 
elic. operations. This is a very useful system 

IIIV ' -. 'MM. "m:. -Hi -. .i/lS.h !, 

is of prime importance. There are aha many other areas 
where unsigned BCD is used to greal advantage, more 
usually within ihe games environment for keeping tabs 



for ihe 



Okay. then, this wraps up the final discussion. I hope thai 
our short excursion into the realms of Numbers and Bytes 
has helped clarify some of the aspects of the numbering 
systems and theii effect'- on bytes for you in some way 
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Now you can develop youi 



by FERGAL MOANE 



Basic is ideally miIIki to writing 'ser ..u, prngrams like- 02A7-02CC 

databases or utilities, where speed in mil nei e«ar\ It is 030O-O3FF 

easy to learn and debug, and a great deal of memory 0400-07E7 

managemenl is done for you. Arrays and Wings are easy 07FB-07FF 

to store and manipulate. Unfortunately, Basic 2 is not 0800-8FFF 

very helpful in easing the workload. This is where 9000-9FFF 

Busilwiit. com.s in. Ifs fiftv-odd commands give you .1 AOiXi-BFU- 

lull WIMP environment and assist with I/O and variable COOO-CFFF 

manipulation. It has an interpreter as large as the CH's DO00-DFFF 

(BK) but still leaves you with 34K for yourself! EOOO-FFFF 



TEM1 1 . DATA AREA 

COMMAND VECTORS AND BUFFER 

SCREEN 

ICON POINTERS 

MAIN BASIC AREA (34K) 

INTERPRETER ANDCOMMAND CODE 1 

BASIC KOiVl/VVINDOW STORAGE 

COMMAND CODE 2 

VIC SIDCIA I01+2 

KERNEL ROM/FREE STORAGE AREA 



POINTS TO NOTE 



1) All ordinary programs will work in the Busit 
environment, but obviously Bus/basic programs will 
work « itli Bu'iiljflsic present. 

2) There are a number of commands which use 
system interrupt. These will not operate at the same t 
and the last estiruleri command i\ iil have priority. 

3) Watch out for Basic strings corrupting Busib; 
Locations 52 and 56 should always be below 14 
crash will nearly always he the resull of corruption. 



BUSIBASIC USERS GUIDE 



MEMORY ALLOCATION 

Although Busibasic takes up a huge 8K of RAM, you are 
left with 34K free for Basic. Tin' area from SOiOO-SDlHKi 
.-,111! Mf»0-SAO<JC) are strictly reserved and any attempt 
to overwrite these areas will crash your program. Zero 
Page is used intensively, especially' locations $FB-SFE. 
There is no room in the machine for any other machine 
code, except by lowering Basic. 

1 o preference for screen and graphics data. 
y particular location for graphics, and 
II detect the new screen location and 
adjust accordingly. 

MEMORY MAP 

HEX LOCATION DESCRIPTION 



The dollar si«n allow- 
in variables. e\|.mssio 
hex number by tl 
equivalent will be c; 
EG. SYS $9400 

POK£$D000,$FF 

PRINT SFF 



iaiy or commands follows. Error 
sd and a command summary is 



u Idled and processed. 






The percent sign followed by a I 
the use of binary constants 
especially useful in setting indiv 
EC. POKE 54296,%! 0001 Oil 



0000-OOFA 
0OFB-O0FF 
O1O0-02A6 



hash; workspace 
busiiiasicparamfter block 
stack and zero page 
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included for compatibility with other DOS Support ARROW 

programs. See DOS for ,i full rlesc riplion op syntax. Syntax: ARROW speed.tol or 

Haa aim. PDlhlTtD 



See also: .PROC .ENDPROC 



DEFPROC di 



procedure. Anyone who has used 
Wtll know how useful a procedure is. Il is in 
ni-program, separate from the rest of the 



ARROW allows paramel 
POINTER command. The 
faster the pointer moves. 
normal colour codes. 



to be specified for the 

ler the speed value, the 
:ol our parameter tolkuvs 



effect . 
progra 

(Mumpers passed In il. .DEFPROt. denne.-. a procedure 
with the name procname. This name can be up to 128 
characters long and is used to reference the procedure 
with the .PROC command. The optional parameters 
allow variables to be spec ii'iecl inside: brackets separated 
by commas. These variables f.111 he passed from the main 
program In the procedure and used there. 



EC. 10 



70 



.DEFPROC WAIT(N) 

Tl$="000000" 

IF INTCFI/60) < NTHE 

.ENDPROC 

.PROC WA1T(5) 

SEC=10 

.PROC WAIT(SECi 



This procedure allows a program to be paused for a 
certain number of seconds. The proi edure is c omplelely 
independent of the main program. It is impossible I" ;;ive 
a full explanation ol procedures in this small spate, but 
see the demo program for examples. 



BAR 

Syntax: BAR screen local inn,colaur,heighI 
See also: LOCATE BOX WSTORE WDISPIAV 

BAR draws a vertical solid bar wilh resolution of one 

compatible with ordinary text. The bar is always eight 
dots wide. Screen location is the number from 1024 to 
2024 where the bar is to star! in the screen matrix. Height 
is in pixels! This command allows quite complex 
hisiograms to be drawn very quickly. It is invaluable 
when representing data, and is very effective when 
combined wilh boxes and windows. 



BEEP 

Synlax: BEEP 
Sec also: BOFF 



BEEP sets liii a 'blip' once .i key is pressed. This facility is 
■ok, nd on e\ pensive i uMiiiL.ie'Y ,mcl gives | i n ig 171 I'll s th.ii 
professional iolk h. Il is interrupt driven and will continue 
until RUN STOP/RESTORE is pressed, BOFF is executed, 
or it is cancelled by another interrupt command. 



.ENDPROC 

Syntax: .ENDPROC 

See also: .DEFPROC .PROC 

.ENDPROC specifies the end of a procedure. The 
.ENDPROCs are paired with the last .DEFPROC. Note 
how the area of program marked by a 
.DEFPROC/.ENDPROC is completely ignored until it is 
called by a .PROC command. I'-ch erlures have a full-stop 
in front of the command for easy identification of a 
procedure command. It is possible lo exit before an 
.ENDPROC 



.PROC 

Syntax: .PROC p roe name (optional parameters! 

See also: .DEFPROC .ENDPROC 

.PROC references a previously defined procedure wilh 
the name procname. Control is passed lo the procedure 
and any variables transferred. Execution resumes al the 
nest command after the .PROC when a .ENDPROC is 
encountered. It is similar to the GOSUB/RETURN 
construction. Note that Ihe correct number of values 
must be supplied, but these may he different variables 
from the ones specified in the .DEFPROC command. This 
gives increased flexibility. See the example above. The 
procedure stack can handle around 25 procedures al 
once. See the error message dictionary. 



BINPUT 

Syntax: B I NPUT,X,V," prompt string", length.variable 

See also: 

Busibasic INPUT is an extended INPUT command. The 

Commodore form can be crashed easily and has a 
number of weak points. This allows the inpul of a valus 
siring or numeric, lo the spec ified variable. It will occu 
at the specified XY position and will not exceed thj 
length given. Editing is supported, hut the cursor canno 
move out of the given area. Once RETURN is pressed, 
control Is returned lo your program, wilh the variable 
specified containing the input. Note thai the pi 
string is optional. 



BOFF 

Syntax: BOFF 
See also: BEEP 

This command switches the keybeep off. It will 
any other undesired interrupt commands and n 
HIV to normal. 



BOX 

Syntax: BOX slartX.fi nishX,startY,finishV,top li 
line, co lour, reverse flag 
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See also: WSTORE WDISPLAY 

BOX draws a character Graphic box of ihi 




DAPPEND 

Syntax; DAPPEND"filename" 
fled See also: DLOAD 



ierJ and tested subroutine; on disk to be appended io 
your latest program. Try and make sure that the line 
numbers are different or problems could occur. Use the 
DLIST command to make this check 



DIR displays (he directory of the disk in the drive 
directory can be slowed by holding down the CTRL 

DLIST 

Syntax: DLIST"filename" 
See also: TYPE 



effect. The top and bottom lir 

drawn inside the main Inn. Thi 

an option, or tin' underlining 01 a title. They are Y vafi 

only, and should fall between startY and flnishY. The 

reverse flag will fill in the box with the foreground colour RETURN 



DLIST Will list slu- H.iMi- |jiO|jr,iJii sped tied directly from 

two lines to be disk. This means that the program is not loaded, and 

the highliting of other programs can be examined without disturbing the 

— "-sic program. Lines can be grabbed by DLISTing 

rrecl place, pressing 5TOP and pressing 

'— " This has proved t< ' 



any other value will draw an empty bo*. See very useful command. See TYI J f I'm listing other lilelvnes 

10 program for effective use of the BOX Note that DLIST is not very reliable with control 

d. characters or BUSIBASIC commands. 
Ill, J !),5, 14,6,13,1,0 



DLOAD 

Synatx: DLOAD "filename" 

See also: DSAVE DAPPEND 



CLINE 

Syntax: CLINE linenumber 
See also: CLS LOCATE 

DLOAD merely loads the specified Basic program from 
CLINE clears ,1 ln>ri/.intj| line ol the screen. Linenumber disk. No ,B is needed after the filename. DLOAD"*" is 
is a Y value between and 24. It allows clearing oi much neater than LOAD" - ", 8 
■'-- : n parts of the display without disturbing other 



n data. It c 






CLS simply clears the Si 



e used for special 



DOKE 

Syntax: DOKE location,16 bit value 

DOKE performs a double-byte POKE. It will split the 1 
bit value into high and low bytes and store them > 
location and location+t in the correct order. This i 
useful for setting vectors, start of Basic etc. and it i 
improved when you realise that hex or binary values ca 
be used. 



COLOUR 

Syntax: COLOUR c 

COLOUR simply w 

without having to u: 
locations. 



>or, background,! i 



! up the three colours of the screen 
■ any POKEs in difficult to remember 



DOS 

Syntax: DOS "command" 

OR DOS 

OR DOSS 
See also: @ DIR 

DOS is a multi-function co 
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operating system. DOS"command" will send any 
command thai would normally be sent b) 
OPEN15,B,15,"command":CLOSE 15. Il allows thE 
scratching and copying of files etc. See the drive 

i'..inill>ii[.>t for more intonriiition. These commands arc 
essential when working with business programs. 
DOS will dispi.:v the contents ni the disk error channel ir 
reverse video. Il will explain the cause of the flashing 
LED on the drive. DOS should be used after every majoi 



DSAVE 

Syntax: DSAVE"filename" 

See also: DLOAD 

Saves the current Basic program to disk with the specified 



SYS S'M(H) will restore these definitions after RUN 
STOP/RESTORE. BOFF will disable the function keys. 
When defining your own function keys, there is a limit 
of ten characters on each key. A carriage return is 
signified by ,i back arrow. Separate each definition by a 



ICON 

Synatv: ICON icon number,ftag 

See also: SETICON POSICON PTRICON 

ICON enables or disables one of eight icons. Icons run 
from 0-7 and are sprites. They follow all the rules for 
sprites, and the four ICON commands take the place of 
the dozens of pokes necessary for sprites. Icons can be 
designed with any sprite editor. They are useful in giving 
i graphic representation of a program or operatroi 



I Wlr. 



. Set 



the 



: in fronl or the filename. 



Programmer's Relerenoe Guide for an easy introduction 
in icons/sprites and the techniques associated with them. 
Fl,;g deli.'! ir. nes whether the icon is to be switched On or 
off ■ is off and 1 is on. 



See also: FKEY 

Performs a dump of the text screen to a devic< 
This is a relatively fast method, and takes care til ASCII 
conversions. If a printer is not connected, the screen will 
be dumped to the" screen! You may like to assign this 
command to one of the function keys for a one-key 



INSTRING 

Syntax: INSTRING target st ring, search string,resul 
See also: VARPTR 



INSTRING finds the occurrence of one string within 

anoiher siring. It is useful in anything requiring a search 
facility. The target string is compared with the search 
string, and the first occurrence of Ihe search string within 
the target siring is noted. This value is passed back in the 
result variable 



FAST 




Synalx: FAST 


EG. INSTRING A$,B$,RESULT 


See also: SLOW 






occurrence of BS> within AS. 


FAST increases the j 


ocessor dock rate by switching off 


the screen and sp 


lies and setting interrupts to a 




crease of around 10% is usual. This JOY 


is useful in speeding 


up operations where the screen is Syntax: JOY 


not necessary. 


See also: BOFF MENU 



FKEY 

Syntax: FKEY"F1,F3,F5,F7,F2,F4,F6,Ff 
See also: BOFF 



function keys. The fund 


BusiIi.isic as below: 


F1 - DOS 


F3 


DIR 


F5 


LIST 


F7 


RUN 


F2 


DLOAD 


■ F4 


DSAVE 


F6 


OLD 


F8 


QUIT 



JOY provides a useful editing fin ility. It allows you t 
position the cursor by using a joystick in port 2. 
simulates the appropriate cursor key press, and ca 
therefore be used within programs requiring curse 
movement. It is interrupt driven so BOFF will disabl 
JOY. The fire-button simulates the RETURN key. 



KEYWAIT 
Syntax: KEYWAIT 
See also: 

KEYWAIT will wait indefinitely for a keypress. This saves 

the use of GF 1 and is uselu' in many ,ip|j I i cations. This 
command is not ideal for receiving a value from the 
keyboard, but location 2 will contain the value that 
would have been in location 197, See a reference guide 
for details of these values. 
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LOCATE positions the cursor at the v,y pavilion where 
is less than 40 and y is less than 25. Use this ii 
conjunction wilh Ihe prim command tor accurate lex, 
positioning. It is faster and neuter than cursor commands 



LOWER 

Syntax: LOWER 
See also: UPPER 

LOWER switches lt> tin; CM'i lowercase business mode 
character set. This reduces the graphics characters 

available to you, but is essenlial for word processing. 
Note lli.il graphics characters used in BOX ami BAR may 
be affected. This command should lie avoided if you are 
moving your character sets. 



POINTER 
Syntax: POINTER 
See also: ARROW JOY 

POINTER will display a joystick driven pointer on-screen. 
It is controlled hy lh.- port 1 joystick and cannot move off 
I he screen. The routine; will lake control of your program 
until the fire button is pressed, indicating that, a screen 
item has been selected. You can then get three items of 
information about the pointers location. 

251 - X co-ordinate 0-39 

252 - Y co-ordinate 0-24 

253 - screen code of character under cursor 

PEEK the above locations to find the correct information. 
The X and Y co-ordinates are most useful as they relate to 
screen positions rather than sprite positions. Use this to 



See also: WSTORE JOY 

MENU creates drop down menus similar to those found 
on the Amiga. It stores the screen before the menu is 
displayed, and replaces it after the choice has been 
made. Return variable should be an integer; this will 
contain the number of the chosen option. An 
ON..COSUU structure could be used to handle this 



The choice array should be a oi 
array. The [ilmienl (I is displayed al the top of ihe menu 
as a title and cannot be chosen. The other elements (up 
to 23) should In; strings of eight characters or less. These 
choices can be scrolled up and down with the cursor 
keys, or joystk k hy usin« the JOY command. The current 
option is highlighted in black. Control is returned to your 
program once a choice has been confirmed by pressing 
the Return key. 

Zone ranges between and 4 and determines where the 
menu will appear on screen. is flush to the left border 
while 4 is flush lo the right border, 



ir keys and space can be used to control the 



subroutine. Subroutines can be branched out of, but the 
return address is left on the stack and clogs it up. This 
results in an eventual OUT OF MEMORY error. POP 
allows the program to ignore the existence of a 
subroutine. This me, ins 1b.il POP is used just before a 
jump out of a subroutine. This might just be a saviour to 
your program structure! 



eg.MENURT%,AS(0),2 

MENU stores it's screen information in the same area as 
Ihe window commands. To avoid corrupting windows, 
create a dummy Window which fills ihe screen. This will 
take up the correct amount of space for the MENU screen 
store, and avoid touching other windows. You should of 
course not use that particular window. 



POSICON 

Syntax: POSICON icon number,X,Y 

See also: PTRICON ICON SETICON 

This command Positions; an ICON. The icon number is 
the standard identifier from D-7. X and Y are in the 
normal sprite ranges. Experiment to find the border 
positions on your monitor. There is no need lo fiddle 
about with the MSB of X - X numbers over 255 will be 
automatically calculated. Note that the tilher three 
commands must be used before the icon becomes 
visible. 



OLD 

Syntax: OLD 
See also: QUIT 



PTRICON 

Syntax: PTRICON icon number,design block 

See also: POSICON ICON SETICON 

t a Basic program after a reset or a 

will restore pointeis and give a listing PTRICON sets the PoinTeR lo the appropriate ICON, This 
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is essential lo led Busibasif where your icon definition 
starts in memory. The design block is calculated by 
di\ iriiru; the a (id less from the start »1 the bank by 64. For 
most applications where bank is in use, just divide the 
address by 64. 



QUIT 

Synlax: QUIT 
See also: OLD 

QUIT will return to the no 

■Ash''"- Il " 'I' I 1 "!''" 1, [i'-l-iil-.l'-i 

still in memory. Basil programs ; 
QUIT command. You can return 
SYS 37888. This means that you 
Busibasic at will. 



Commodore upeialinu, 

isibletu tin-- system, bill 

an? not affected by L I . l ■ 

Busibasic by typing 

i exit and return to 



SLOW 

Syntax: SLOW 
See also: FAST 

Sl.i )VV restores the screen and reverts to normal speed 
after a FAST call. It should ONLY be used after FAST has 
been used. This Is because FAST stores essential 
inloim.5lii.in in the | wr a meter block at 251. If this has 
been corrupted by other Busibasic commands, the 
SLOW command will crash the C64. 



SORT 

Syntax: SORT array name 

See also: VARPTR 

SORT performs a speedy sort of a string array ii 
alphabetically ascending order. This is a very use 
command in business programs. The array name sho 
only be the first one or two letters of the array name ( 



n location, number of characters 



REVERSE 

Syntax: REVERSE si 
See also: CLINE 



REVERSE topics specified characters between reverse 
and ordinary mode. This is useful lor highlighting a title, 
or for drawing a bar. It is thousands of times taster than 
it's Basic equivalent. The screen location should be the 
number between 1024 and 2024 in the screen matrix 
where the reverse should start. The number of characters 
is obviously the number oi screen pu.-ilions th.it should 
be reversed. This could be useful in conjunction with the 
POINTER to indicate what has been selected. 



tensional and ha\ 
jr messages for mi 



See also: DUST 

TYPE displays the contents of a file directly to the screen. 
This often results in rubbish, but it is very successful with 
sequential files. Basic programs should be displayed with 
the DLIST command. The filHypcs. are shown below: 

S - sequential 

P - program 
L - relative 



SETICON 

Syntax: SETICON icon UPPER 

number,type,colour,Xe\p,Yexp,priority,Loli)ur1,colour2 Syntax: UPPER 

See also: POSICON PTRICON ICON See also: LOWER 



SETICON -.els up parameters for icons. The type should 
be for hi-res and 1 for inultir oloiir. Colour is obvious. 
Xexp and Yexp determine if expansion is switched on 
or off on the icon, for off and 1 for on. Priority dictates 
the priority of the icon over the background, 
background and 1 icon. The two following colours are 
only specified if the icon is in multicolour mode. All 
colours are from to 15. SETICON should be used along 
with Ihe other commands In make an iron visible. 



s the C64 to the default capita Is/Graphic 



VARPTR 

Syntax: VARPTR variable, re turn variable 
See also: SORT 



nited in it's usefulnr 



SLEEP makes your | m isj.ram pause for a sped lied anioun 
of time. This allows the user lime to read displays etc 
and avoids the use of clumsy FOR. .NEXT loops. The timi 
■. 1 1 ( :■ l 1 1 1 1 in' lietv.-i en and l.i . (■ ■■ . i , : i ■ . . i ■. . 
multiply the time figure by 4 for the time in seconds, Thi 
of course varies with the interrupt rati?. 



WCLR 

Syntax: WCLR 

See also: WDEIETE WLOAD 

WCLR clears the area under the Basic ROM for the 
storage of windows. It MUST be used before any window 

commands, and it is wise to include it at the start of your 
program. The windows will not work wilhoul first being 



ON THE DISK 



WDELETE 

Syntax: WDELETE window number 

See also: WCLR 



e li | j memory tor other 



WINDOW ERROR 



This command is the heart of the window operating 

system. It stores ,t spo< it'ied section of the screen to an 3K 

buffer, assigning it a unique Window number. Note lhat a 

border is not drawn around the window;, the BOX 

command has been designed lor this purpose. You should 

dow from the make sure lhal all parameters are correct or you will get a 

indows. Make WINDOW ERROR. See the Error Dictionary for an 

iu will gel a explanation of the numbers. Be sparing with your width 

and height settings or you will run oul of memory. 



WDISPLAY 

Syntax: WDISPLAY window number,X,Y,flag 

Sec also: WSTORE 

WDISPLAY displays a previously stored window lo the 
screen. A copy of the stored window is left in the buffer. 
The window foments will be displayed at the X and Y 
cursor position specified. This is flexible, as the X and Y 
positions tor displaying need not be the same as those 
when storing the window. 

Flag has an important bearing on how the window will 
be displayed: 

flag= the window will overwrite the screen 
flag= 128 the window will have reversed colo 
flag= 64 the window is swapped with the scrt 
flag= 192 the window will have reversed colo 

The last two values are potentially most l 
repeating the command will restore the origin, 
alter the window has been used. 



ERROR DICTIONARY 



as modifying 



i. ARRAY NOT FOUND 

A string array has been referenced in a SORT command 
which does not exist. Make sure that your array has been 
dimensioned properly. 



display f.END WITHOUT PROC 



WLOAD 

Syntax: WLOAD"filcname",8 

See also: WSAVE 

WLOAD will load a previously stored set of windows into 
the buffer area under the Basic ROM. This means thai 
windows can be created and stored outside your 
program, and your program can access them as they are 
needed. The inclusion of this command means that the 
number of windows is only limited by disk space. Note 
that WCLR is not necessary if WLOAD is used. 



An .t-M II'KOC has been found without ,i correspond ie,n 
.[H.I PROC. This is similar to 'RETURN WITHOUT 
GOSUB, Mkae sure that all procedures have associated 
.DEFPROCs and .ENDPROCs and you will have no 
bother. Note that the line number specified is the line in 
which the procedure has been called by .PROC 



riLLEGAL VARIABLE 



?NO.END FOUND 



WSAVE 

Syntax: WSAVE" filename", 8 A .DEFPROC has been foul 

See also: WLOAD associated with it. Always c 

.ENDPROC 

VVS.-WI- saves the UK window buffer area under the Basic 

ROM to disk. Windows can In: created and stored outside 

of your program, and WLOADed when needed. This ?NOT ENOUGH ELEMENTS 

shortens your progiam, and provides scope lor a huge 

amount of information to be stored on disk and accessed 

when required. WSAVE will only save the number of 

windows that have been used, therefore using as little 

disk space as possible. 



A siring array has been spec it'ied in a SORT 
it has only one clement. An array of one siring 



WSTORE 



JOUT OF MEMORY 



. 



ON THE DISK 



The 256 byte procedure/ buffer has been tilled and there 
is no more room lor procedure del] nil inns. There is room 
for approx. 25 definitions in one program, though this 
amount Is rarely exceeded. You could also have loo 
many nested FOR.. .NEXT or GOSUB... RETURN 
s. Try using POP to escape from subroutines. 



'SYNTAX ERROR 

The Busibasic interpret? :■' .. ■■,-.,,■,■ mil V imr Ha-i. 

program line, and the emir < annot I:, inr udi d in the 
other categories. Check tl e spe ling of the i ommand 
lhat parameters are in ran,;?, that commas are in the r ,,-i 
places and thai you have suppled the conuct amount or 
parameters. 



'TOO MANY DIMENSIONS 

Thy SORT command can only deal v 



fTYPE MISMATCH 



Busibasii: expected a certain variable type which was not 
provided. Maybe you put a string in place of a number 
or vice-versa. This can also occur if (he variable type 
expressed in a .PROC is not the same as in the 
associated .DEFPROC 



?UNDEF. PROCEDURE 

You have called a procedure by a name which cannot be 
found in a .DEFPROC command. Check (he spelling or 
both procedure names. 



WINDOW ERROR 

You have made so; 
command. Their nu 



MEANING 

SYSTEM FAILURE-RELOAD 

BUSIBASIC 

NO WINDOW EXISTS 

WINDOW ALREADY EXISTS 

BADX 

BADY 

BAD WIDTH 

BAD HEIGHT 

BAD X + HEIGHT 

BAD Y + HEIGHT 

BAD WINDOW NUMBER 

NO MEMORY AVAILABLE 



DEMO PROGRAM 

The Busibasic demo program is loaded from Busibasic 
by typing DLOAD"BU5IDEMO". It is an attempt to 

demonstrate how a file handling desktop environment 
could be created. Il is not an elegant piece of 
programming. but il works and it shows off the system 
and it's commands. It could be improved further by the 
Utilisation ol windows, icons and properly structured 
subrouiines. 

When writing -his I noticed something odd. I have set the 
pointers for strings ,md liasic storage at 52-5.! and 55-56 
to S8FFF, just below Busibasic. This is lo ensure thai it 
does not get corrupted. But during development, I 
noticed lli.it the Basic 2 system kept resetting (he string 
pointer to SAOOO. This is in spile of the fad that the 
highest legal address in 5:5 and 36 was still SBFFF! This 
results in the frequent corruplion of (he Busibasic 
operating system by variables. Is this a bug in the ROMs 
or my programming ; Either way, you will have to be 
very careful about variables; save your program 
regularly. 

When the desktop is up and running you have a joystick 
or cursor-keys controlled pointer. The bar at the bottom 
is disk status. The bar on the right is the amount of space 
it disk. The bigger the bar, the more space 




available. The bar along the lop m 
the three pull down menus. The a 
all dialog takes place. Clii 
ponents and they will 
iriplion of the 



is free memory and 
e window is whei 
on any of the; 



DISK: Normal disk commands. Type the required |6 
, and click on cancel or confirm when prompted. 
•e this menu, 

EW: The most important menu. DIR will slowly 
ad the directory in from disk into an array. It will 
splay the filenames in blocks of ten. Click on 
minue at the bottom of the window to see more 
snames. DIR should only be used when a new 
sk has been inserted. LIST will display the 
Hiames again withoul any disk access. Click on 
y of the filenames to load thai particular file. This 
active at any time when a filename is in the dialog 
ndow. The file is presumed to be Basic. SORT will 



ON THE DISK 



t the directory inlo alphabetical order. DUMP will 
nl the directory ro a device 4 printer. When used with 
t„ this is a very powerful asset. Use DIR to return to 
■ normal format directory. 



.PROC procname (optional parameters) 

ARROW speed,colour 

BAR screen location,co lour, height 

BEEP 




CLOSING POINTS 



BOX x1,x2,y1,y1,top line.boriom 
line, co I our, re verse flag 
CLINE screen line 

CLS 

COLOUR cursor, background, screen 

DAPPEND "filename" 

DIR 

D LIST "filename" 

DLOAD "filename" 

DOKE location^ 6-bit value 

DOS 

DOS "disk command" 

DOS$ 

DSAVE "filename" 

DUMP 

FAST 

SLOW 

FKEV'fl ,f3,f5,f7,f2,f4,f6,f8" 

ICON icon number,flag 
INSTRING target string,,search string, result 
|OY 

KEYWAIT 
LOCATE x,y 
LOWER 



., within the constraints of a magazine. There i; 
bound to he something that I have forgoilcn lo mention. 
My advice: experiment. 

The demo program provide I should poinl Ihe way lo the 
using of (he commands in a program. 
There may even be some programming oversights t 



OLD 

POINTER 

POP 

POSICON icon number,x,y 

PTRICON icon number.design block 

QUIT 

REVERSE screen location, number of characters 

SETICON 

icon number,type,colour,Xexp,Yexp,priority, 

col1,col2 

SLEEP time 

SLOW 

SORT array name 

TYPE"filename,filetype" 
BUSIBASIC COMMAND SUMMARY UPPER 

VARPTR variable, return variable 
$ hexnumber WCLR 

% binarynumber WDELETE window number 

WDISPLAY window number,x,y,flag 

WLOAD "filename",8 

WSAVE "filename",8 

.DEFPROC procname (optional parameters) WSTORE window number,x,y,width,heieht 

.ENDPROC 



If you have any bother using Husibasic, you c 
me through the magazine. However, exam pre 
postpone a reply. I certainly use Busibasic to make my 
program mini; life- easiur - I hope thai you find the same 
use for it. The Editor may even consider publishinu 
programs wrilten wilh Ku~ibasi[ . Why no! try your luck 
and submit your masterpiece ■ it may earn you some 



S"disk command" 






OIM THE DISK 




I was at my computet one night, experimenting with (from the program CHARS. MO a 

strings and the commands thai deal with them, when, effects that can be made. You ther 

quiteby accident, I discovered a small routine that could loading the Basic Slider routi 

improve the presentation of a program with a large demonslralion tfi have another look 

number of text screens. or resetting the computer. 



HOW IT WORKS 



MERGING IT IN 




haracter from the You can put the routine into your own program by 
nting them on the loading the SLIDER.SUB program from the disk and 
i would print S, IS, building your program around it, or using a MERGE 
of the line sliding command from a Version of extended basic, or you can 
use this method, which is slightly more complicated. 

Merging one prow am "ltd another require ripening the 
start of the BASK." locations to the end of your current 
program. You can find where your program lies by 
PEEKirtg locations 51 and 52. You then set the start of 
BASIC" locations to Ihese values, and vou can now load 
the routine in. Once it has loaded, POKE 43,1 and POKE 
44,B to gel your original program back. 






e the 
51 put thes 



d lin 



at the front of 



The routine, tiled on the disk as SLIDER.SUB, when 
given a line oi ttvt 4l) characters long in A$, will slide it 
across the line on the screen character by character, 
which would make the screen more interesting, to took 

commands part of your program: 



10 AS="TEXT 40 CHARACTERS LONG" 

20 GOSUB 10000 

30 .... rest of program .... 

The routine supports user-delmed characters, an 

ii- il mlerrupl !'■■ v.irah c in ,i piii;,;r,ii:i .is loni; 
is not used. You can also pm a delay between 
letter, by adding I he follow ins; line to I he rouhne: 

10007 FOR <variable>=0 to <delay>:NEXT <varia 

DEMONSTRATION 



Also on the disk is a demonstration program called 
Basic Slider, which shows how the routine works with 
another program, and uses user-defined characters 



1A=A+1:IFA=1 THEN LOAD "CHARS.MC",B,1 

2 IF A=2 THEN POKE 53272,24 

To switch off the characters, type POKE 53272,21 

BASIC SLIDER 

Basic Slider is only a simple way of sliding text. A 
machine code version would slide the text much more 
sinoiiihlv, and would allow i o lours and sound to be used 
as well, but as this is beyond me (at the moment), 
perhaps a talented machine cork- programmer will come 
up with a better version. 




-ADVENTURING 




Character Anii 



JASON FINCH 



This is only ,1 shun Advenlure Writing |u>l to I'injsli off Ihe 
section on character animation. In Ihe next article we 
will starl on Ihe programming jewels of the adventure. 
Yippee! I will have finished with the theory and ideas 
behind writing an adventure so we will be able to 
embark on how to actually get the thing op and running. 



COMMUNICATIONS 



Here of course we are mil thinking of selling up our own 
telephone network or anything throughout the adventure; 
we are talking ahoul the p layer communicating on a one- 
to-one basis wilh the other characters. You must also bear 
in mind how the computer will tell the player what 
actions the other character is performing, if any, and also 
what is happening elsewhere in the adventure if it is of 
importance. 



TALK TO THE ANIMALS 



The most obvious way in an adventure that the player 
talks to the animals and other characters is by way of the 
SAY and ASK commands. These usually take the form 
SAY HELLO TO THE ELF. However, you may want to 
make your adventure so that quote marks are required 
around the speech, this is probably best hocause it 
clearly defines what the player wishes to say. And how 
are you going to make your adventure cope with inputs 
thai arc "around the wrong way" such as SAY TO THE 
ELF HELLO. Quote marks make il easier to instantly pick 
out the tew: SAY TO GANDALF "PICK UP THE AXE", I 
won't go to deeply into the way that your program will 
analyse that particular command ■ that will be talked 
about nestt month. Suffice it to say thai Ihe program will 
take the worrits) immediately iollowing 'TO' to be the 
character anri the word(s) in the quotes to be what you 
wanl to say. It really is as simple as that. You musl make a 
clear distinction between SAY and ASK if you are to 
include Ihe ASK option. You should ensure lhat SAY 
"HELLO" TO THE ELF creates a suitable response 
whereas something like ASK THE ELF "HELLO" sounds 
obviously strange. You usually ASK a question, not a 



, 



RESPONSES 

When the program has sussed out who it is you w 
lalk to anri what it is you wish to say, Ihe computei 
decide whal a suitable reply for that character would be. 
This is a simple form of Al (Artificial Intelligence to mo: 
people). You musl choose how u implex you want th 
communications side of your adventure to be. If yoi 
have no characters then all well and good, you don 
need to worry about t ommunicating, but the mon 
characters you have, and ihe more you want the playei 
to rely on speaking to others (which shouldn't be 
much!) then the more complicated your speech ana 
routine will become. If it isn't all that important ihen 
can have a set of fixed responses in certain statement 
questions. Otherwise you can have the routine "think" 
out what sort of question is being answered and then pul 
together a reply. For instance, the former may result in 
the computer displaying "The little man says 'no'" if you 
say to him PUT THE CUP ON THE TABLE, whereas the 
more advanced reply routine may say "The little man 
says he wants to hold the cup". This response would be 
changed if you said PUT THE SWORD ON THE TABLE 
or something. I hope that will give you some food for 
thought on the complexity of your routines and whether 
you actually need a super-advanced system. 



WHAT'S HAPPENING? 



The last word for now on communications is telling ihe 
player whal other characters are actually doing. Most of 
IT!-, will l» '.,•■-•: ii lu I in- ii'.. i;:-..vtn-!iri:; .i'-:iiri- -r. lion 

next time, but for now just give a hil of thought to the 
personalities thai your characters, if any!, will have. In 
The Hohbil there was one character that constantly 
talked to himself. Fine, so you display messages like "The 
eli talks quietly to himself". Bui movement is harder to 
do. The ideas are simple enough, "The guarri leaves [he 
room". But how will it be possible lo lell whether he can, 
and how will Ihe computer know where he should then 
be placed? All will be revealed next month!! 

With a bit of luck this won'l have extended too far onto a 
second side, ii al all. So without further ado, I shall SAY 
"CHEERIO FOR NOW" TO THE READERS! See "you all 
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Every program written by a mathematician who has spent many 
years in the betting industry. Programs that utilise the tried and 
trusted methods of the professional, not pie in the sky theories 
that fail to pass the test of time. 
FOOTBALL BOXFORM Written by a tamer pools eipert (or 



POOLS PLANNER by the same author. Full details given of 36! 
easily entered block perms ranging from 9 to 73960 lines and 
from 12 to 56 selections. All are accepted by the pools firms 

and are checked in seconds by your computer. 
RACING BOXFORM Cora cnaraewsrics (built n to the program) 
as well as the torn of the rrarsea are considered to speedily produce an 
order of merit for each race. Designed for flexibility allowing users to 
amend the program ft they wish. Price still includes the highly 
acclaimed HANDICAPWIMER -more than iOuu winners everyyear- 
25% ot then) at 5/1 or better. Order two or more and receive fB£E 
loiram lo work out almost any bet. So good its used by bookies. 
ices ( Tape ) £15.95 each. £25.95 any two. £35.95 all 
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